StarterGui

Tampilkan yang Tidak Digunakan Lagi

*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.

Tidak Dapat Dibuat
Layanan

StarterGui adalah objek wadah yang dirancang untuk menampung objek LayerCollector seperti ScreenGuis .

Ketika sebuah Player.Character muncul, isi dari PlayerGui (jika ada) mereka kosong.Anak-anak dari StarterGui kemudian disalin bersama dengan keturunan mereka ke dalam PlayerGui .Perhatikan, bagaimanapun, bahwa objek seperti dengan set properti mereka hanya akan ditempatkan ke dalam setiap pemain sekali dan tidak akan dihapus saat respawn .

StarterGui juga termasuk berbagai fungsi yang memungkinkan Anda berinteraksi dengan CoreGui .Sebagai contoh StarterGui:SetCoreGuiEnabled() dapat digunakan untuk menonaktifkan elemen dari CoreGui , dan StarterGui:SetCore() dapat melakukan berbagai fungsi termasuk membuat notifikasi dan pesan sistem.

Rangkuman

Properti

Metode

Metode diwarisi dari BasePlayerGui

Properti

ProcessUserInput

Tersembunyi
Tidak Direplikasi
Keamanan Plugin
Baca Paralel

Memungkinkan StarterGui untuk memproses input seperti PlayerGui dan CoreGui melakukan. Nilai default adalah false .

RtlTextSupport

Tidak Dapat Ditulis Skripnya
Baca Paralel

ScreenOrientation

Baca Paralel

Properti ini mengatur mode orientasi layar terfavorit untuk pengguna dengan perangkat seluler. Untuk mode yang berbeda yang tersedia, lihat Enum.ScreenOrientation .

Secara default, properti ini diatur ke Sensor , artinya pengalaman ditampilkan tergantung pada pertandingan terbaik dengan orientasi perangkat saat ini, baik landscape (kiri/kanan) atau portrait.

Ketika sebuah bergabung dengan pengalaman di perangkat seluler, properti ini menentukan orientasi awal perangkat dan mengatur orientasi pemain itu sesuai dengan itu.Anda juga dapat mendapatkan orientasi layar saat ini pemain melalui PlayerGui.CurrentScreenOrientation , berguna saat menggunakan salah satu pengaturan " sensor" Enum.ScreenOrientation .

Perhatikan bahwa mengubah properti ini tidak akan mengubah orientasi layar untuk Players sudah dalam pengalaman.Untuk mengubah orientasi untuk pemain yang ada, gunakan properti PlayerGui.ScreenOrientation mereka.

ShowDevelopmentGui

Baca Paralel

Properti ini menentukan apakah konten dari StarterGui terlihat di Studio.

VirtualCursorMode

Tidak Dapat Ditulis Skripnya
Baca Paralel

Metode

GetCoreGuiEnabled

Fungsi ini men返ikan apakah Enum.CoreGuiType yang diberikan diaktifkan, atau jika telah dinonaktifkan menggunakan StarterGui:SetCoreGuiEnabled() .Fungsi ini harus dipanggil pada klien.

Perhatikan bahwa pengaturan "TopbarEnabled" ke false menggunakan SetCore() menyembunyikan semua CoreGuiTypes tetapi tidak memengaruhi hasil fungsi ini.

Parameter

coreGuiType: Enum.CoreGuiType

Yang diberikan Enum.CoreGuiType .

Nilai Default: ""

Memberikan nilai

Apakah yang diberikan Enum.CoreGuiType diaktifkan.

Contoh Kode

The below example would print whether or not the player list is visible to the LocalPlayer.

Checking if a Core GUI is Enabled

local StarterGui = game:GetService("StarterGui")
print(StarterGui:GetCoreGuiEnabled("PlayerList"))

SetCore

()

Metode ini (tidak boleh dikacaukan dengan SetCoreGuiEnabled() ) mengekspos berbagai fungsi yang didefinisikan oleh skrip inti Roblox, seperti mengirim pemberitahuan, menyalakan pemberitahuan untuk lencana/poin, mendefinisikan panggilan kembali untuk tombol reset, atau beralih bilah atas.

Parameter pertama adalah string yang memilih fungsi dengan mana panggilan akan berinteraksi.Mungkin diperlukan untuk memanggil metode ini beberapa kali menggunakan pcall() dalam kasus skrip inti masing-masing belum dimuat (atau jika telah dinonaktifkan sepenuhnya).

Tabel berikut menjelaskan string yang dapat diterima sebagai parameter pertama.Parameter yang harus diikuti tergantung pada fungsionalitas yang akan digunakan dan dijelaskan di sub-tabel.

ObrolanAktif

Mengontrol apakah obrolan aktif.


<th>Jenis</th>
<th>Standar</th>
<th>Deskripsi</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>aktif</code></td>
<td>boolean</td>
<td>(dibutuhkan)</td>
<td>Menentukan apakah obrolan harus diaktifkan.</td>
</tr>
</tbody>
Nama
Notifikasi TitikAktif

Mengontrol apakah notifikasi untuk poin pemain yang diperoleh akan muncul.


<th>Jenis</th>
<th>Standar</th>
<th>Deskripsi</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>aktif</code></td>
<td>boolean</td>
<td>(dibutuhkan)</td>
<td>Menentukan apakah pemberitahuan untuk poin pemain yang diperoleh akan muncul.</td>
</tr>
</tbody>
Nama
Notifikasi Lencana Aktif

Mengontrol apakah notifikasi untuk lencana yang diperoleh akan muncul.


<th>Jenis</th>
<th>Standar</th>
<th>Deskripsi</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>aktif</code></td>
<td>boolean</td>
<td>(dibutuhkan)</td>
<td>Menentukan apakah notifikasi untuk lencana yang diperoleh akan muncul.</td>
</tr>
</tbody>
Nama
Tombol Reset Panggil Balasan

Menentukan perilaku, jika ada, dari tombol reset yang diberikan boolean atau BindableEvent untuk ditembak saat pemain meminta untuk mengatur ulang.


<th>Jenis</th>
<th>Standar</th>
<th>Deskripsi</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>diaktifkan</code></td>
<td>boolean</td>
<td>(dibutuhkan)</td>
<td>Menentukan apakah tombol reset mempertahankan perilaku defaultnya.</td>
</tr>
<tr>
<td colspan="4"><b>OR</b></td>
</tr>
<tr>
<td><code>panggil balas</code></td>
<td><code>Kelas.BindableEvent</code></td>
<td>(dibutuhkan)</td>
<td>Kelas <code>Class.BindableEvent</code> untuk ditembak ketika pemain mengkonfirmasi bahwa mereka ingin reset.</td>
</tr>
</tbody>
Nama
ChatMakeSystemMessage

Tampilkan pesan yang dibentuk di chat.Menggunakan metode ini memerlukan pengalaman untuk disetel ke , meskipun obrolan lama sudah dihapuskan dan penggunaannya dilarang.Untuk pengalaman yang menggunakan saat ini TextChatService , referensikan ke TextChannel:DisplaySystemMessage() .


<th>Jenis</th>
<th>Standar</th>
<th>Deskripsi</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>meja konfigurasi</code></td>
<td>kamus</td>
<td>(dibutuhkan)</td>
<td>Kamus informasi yang menggambarkan pesan (lihat di bawah).</td>
</tr>
</tbody>
Nama

<th>Jenis</th>
<th>Standar</th>
<th>Deskripsi</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>Teks</code></td>
<td>string</td>
<td>(dibutuhkan)</td>
<td>Pesan untuk ditampilkan.</td>
</tr>
<tr>
<td><code>Warna</code></td>
<td><code>Tipe Data.Color3</code></td>
<td><code>Datatype.Color3.fromRGB(255, 255, 243)</code></td>
<td>Warna teks dari pesan.</td>
</tr>
<tr>
<td><code>Jenis huruf</code></td>
<td><code>Enum.Font</code></td>
<td><code>SumberSansBold</code></td>
<td>Font dari pesan.</td>
</tr>
<tr>
<td><code>Ukuran Teks</code></td>
<td>integer</td>
<td><code>18</code></td>
<td>Ukuran teks dari pesan.</td>
</tr>
</tbody>
Nama
Kirim Notifikasi

Menyebabkan pemberitahuan yang tidak mengganggu muncul di bagian bawah kanan layar. Pemberitahuan dapat memiliki hingga dua tombol.


<th>Jenis</th>
<th>Standar</th>
<th>Deskripsi</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>meja konfigurasi</code></td>
<td>kamus</td>
<td>(dibutuhkan)</td>
<td>Kamus informasi yang menggambarkan pemberitahuan (lihat di bawah).</td>
</tr>
</tbody>
Nama

<th>Jenis</th>
<th>Standar</th>
<th>Deskripsi</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>Judul</code></td>
<td>string</td>
<td>(dibutuhkan)</td>
<td>Judul notifikasi.</td>
</tr>
<tr>
<td><code>Teks</code></td>
<td>string</td>
<td>(dibutuhkan)</td>
<td>Teks utama dari notifikasi.</td>
</tr>
<tr>
<td><code>Ikon</code></td><td>string</td>
<td />
<td>Gambar untuk ditampilkan dengan notifikasi.</td>
</tr>
<tr>
<td><code>Durasi</code></td>
<td>angka</td>
<td><code>5</code></td>
<td>Durasi (dalam detik) pemberitahuan harus tetap terlihat.</td>
</tr>
<tr>
<td><code>Panggilan Balik</code></td><td><code>Class.BindableFunction</code></td>
<td />
<td>Sebuah <code>Class.BindableFunction</code> yang harus diaktifkan dengan teks tombol yang ditekan oleh pemain.</td>
</tr>
<tr>
<td><code>Tombol1</code></td><td>string</td>
<td />
<td>Teks untuk ditampilkan pada tombol pertama.</td>
</tr>
<tr>
<td><code>Tombol2</code></td><td>string</td>
<td />
<td>Teks untuk ditampilkan pada tombol kedua.</td>
</tr>
</tbody>
Nama
TopbarEnabled

Menentukan apakah bilah atas ditampilkan.Menonaktifkan bilah atas juga akan menonaktifkan semua CoreGuis seperti obrolan, inventaris, dan daftar pemain (misalnya, yang ditetapkan dengan SetCoreGuiEnabled ).

Saat dinonaktifkan, wilayah bilah atas yang dulunya ditempati masih akan menangkap peristiwa mouse; namun, tombol yang ditempatkan di sana tidak akan merespon klik.Asal ruang GUI masih akan diimbangkan 36 piksel dari bagian atas layar.


<th>Jenis</th>
<th>Standar</th>
<th>Deskripsi</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>diaktifkan</code></td>
<td>boolean</td>
<td>(dibutuhkan)</td>
<td>Menentukan apakah bilah atas harus terlihat.</td>
</tr>
</tbody>
Nama
DevKonsol Terlihat

Menentukan apakah Konsol Pengembang terlihat.


<th>Jenis</th>
<th>Standar</th>
<th>Deskripsi</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>visibilitas</code></td>
<td>boolean</td>
<td>(dibutuhkan)</td>
<td>Menentukan apakah konsol terlihat.</td>
</tr>
</tbody>
Nama
Permintaan Kirim Teman Cepat

Meminta pemain saat ini untuk mengirim permintaan teman ke Player yang diberikan.


<th>Jenis</th>
<th>Standar</th>
<th>Deskripsi</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>pemain</code></td>
<td><code>Kelas.Player</code></td>
<td>(dibutuhkan)</td>
<td>Pemain yang permintaan teman harus dikirim.</td>
</tr>
</tbody>
Nama
Teman Sebayar Cepat

Meminta pemain saat ini untuk menghapus Player tertentu dari daftar teman mereka.


<th>Jenis</th>
<th>Standar</th>
<th>Deskripsi</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>pemain</code></td>
<td><code>Kelas.Player</code></td>
<td>(dibutuhkan)</td>
<td>Pemain yang seharusnya tidak berteman.</td>
</tr>
</tbody>
Nama
Pemutar Blok Cepat

Meminta pemain saat ini untuk memblokir Player yang diberikan.


<th>Jenis</th>
<th>Standar</th>
<th>Deskripsi</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>pemain</code></td>
<td><code>Kelas.Player</code></td>
<td>(dibutuhkan)</td>
<td>Pemain yang harus diblokir.</td>
</tr>
</tbody>
Nama
Pemutar Memblokir Prompt

Meminta pemain saat ini untuk membuka blokir Player yang diberikan.


<th>Jenis</th>
<th>Standar</th>
<th>Deskripsi</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>pemain</code></td>
<td><code>Kelas.Player</code></td>
<td>(dibutuhkan)</td>
<td>Pemain yang seharusnya diblokir.</td>
</tr>
</tbody>
Nama
Menu Konteks Avatar Diaktifkan

Menentukan apakah Menu Konteks Avatar diaktifkan.


<th>Jenis</th>
<th>Standar</th>
<th>Deskripsi</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>diaktifkan</code></td>
<td>boolean</td>
<td>(dibutuhkan)</td>
<td>Menentukan apakah menu konteks diaktifkan.</td>
</tr>
</tbody>
Nama
AvatarContextMenuTarget

Memaksa membuka Menu Konteks Avatar.


<th>Jenis</th>
<th>Standar</th>
<th>Deskripsi</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>pemain</code></td>
<td><code>Kelas.Player</code></td>
<td>(dibutuhkan)</td>
<td>Pemain di mana menu konteks akan dibuka.</td>
</tr>
</tbody>
Nama
TambahkanMenu Konteks AvatarOption

Menambahkan opsi ke Menu Konteks Avatar.


<th>Jenis</th>
<th>Standar</th>
<th>Deskripsi</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>pilihan</code></td>
<td><code>Enum.AvatarContextMenuOption</code></td>
<td>(dibutuhkan)</td>
<td>Opsi untuk ditambahkan.</td>
</tr>
<tr>
<td colspan="4"><b>OR</b></td>
</tr>
<tr>
<td><code>pilihan</code></td>
<td>meja</td>
<td>(dibutuhkan)</td>
<td>Meja dua elemen, di mana yang pertama adalah nama actionkhusus, dan yang kedua adalah <code>Class.BindableEvent</code> yang akan ditembak dengan pemutar saat opsi diaktifkan.</td>
</tr>
</tbody>
Nama
HapusAvatarContextMenuOption

Menghapus opsi ke Menu Konteks Avatar. Argumen option harus sama dengan yang digunakan dengan "AddAvatarContextMenuOption" (lihat di atas).


<th>Jenis</th>
<th>Standar</th>
<th>Deskripsi</th>
</tr>
</thead>
<tbody>
<tr>
<td><code>pilihan</code></td>
<td>Variasi</td>
<td>(dibutuhkan)</td>
<td>Nilai yang sama diberikan ke <b>AddAvatarContextMenuOption</b> .</td>
</tr>
</tbody>
Nama
Tema Menu Konteks Avatar

Konfigurasi menu konteks Avatar yang dapat disesuaikan Avatar yang merupakan fitur opt-in yang memungkinkan interaksi sosial mudah antara pemain melalui tindakan khusus, seperti memulai perdagangan, pertempuran, dan banyak lagi.Untuk informasi lebih lanjut tentang cara menyesuaikan temanya, lihat artikel Konteks Menu Avatar.

Koneksi CoreGuiChat

Menyiapkan koneksi gateway yang dapat diikat antara tombol obrolan topbar CoreGui dan sistem obrolan lama.Parameter kedua harus menjadi tabel dari BindableEvents dan BindableFunctions.

Parameter

parameterName: string

Memilih fungsionalitas dengan mana panggilan akan berinteraksi.

Nilai Default: ""
value: Variant
Nilai Default: ""

Memberikan nilai

()

Contoh Kode

StarterGui Setting Core GUI

local StarterGui = game:GetService("StarterGui")
StarterGui:SetCore("AvatarContextMenuTheme", {
BackgroundImage = "",
BackgroundTransparency = 0.5,
BackgroundColor = Color3.fromRGB(111, 145, 242),
NameTagColor = Color3.fromRGB(0, 0, 200),
NameUnderlineColor = Color3.fromRGB(213, 233, 255),
ButtonFrameColor = Color3.fromRGB(15, 24, 65),
ButtonFrameTransparency = 0.2,
ButtonUnderlineColor = Color3.fromRGB(213, 233, 255),
Font = Enum.Font.SciFi,
})

SetCoreGuiEnabled

()

Fungsi ini menetapkan apakah elemen CoreGui yang terkait dengan Enum.CoreGuiType yang diberikan diaktifkan atau dinonaktifkan.

Bilah atas tidak dapat dinonaktifkan menggunakan fungsi ini. Untuk menonaktifkannya, atur "TopbarEnabled" ke false menggunakan StarterGui:SetCore() .

Parameter

coreGuiType: Enum.CoreGuiType

Yang diberikan Enum.CoreGuiType .

Nilai Default: ""
enabled: boolean

Apakah untuk mengaktifkan atau menonaktifkan Enum.CoreGuiType yang diberikan.

Nilai Default: ""

Memberikan nilai

()

GetCore

Variant
Hasil

Metode ini mengembalikan set data atau tersedia oleh skrip inti Roblox.Parameter pertama dan satu-satunya adalah string yang memilih informasi yang akan diambil.Bagian berikut menjelaskan string dan data yang mereka return oleh fungsi ini.

Memanggil metode ini dapat menghasilkan. Banyak dari ini juga mendaftarkan fungsi yang setara SetCore() (ini ditandai dengan asterisk).

Notifikasi Titik Aktif *

Kembalikan true jika pemberitahuan titik pemain diaktifkan.

Notifikasi Lencana Aktif *

Kembalikan true jika notifikasi lencana diaktifkan.

Menu Konteks Avatar Diaktifkan *

Kembalikan true jika Menu Konteks Avatar diaktifkan.

ObrolanAktif *

Kembalikan apakah obrolan aktif atau tidak. Ini ditunjukkan oleh status pemilihan ikon obrolan di bilah atas.

Ukuran ChatWindow *

Kembalikan ukuran jendela obrolan sebagai UDim2.

Posisi ChatWindow *

Kembalikan ukuran jendela obrolan sebagai UDim2.

Bar Obrolan Dinonaktifkan *

Kembalikan true jika bilah obrolan dinonaktifkan.

Dapatkan ID Pengguna Terblokir

Kembalikan daftar UserIds yang terkait dengan pengguna yang telah diblokir oleh pemainlokal.

Pemutar Diblokir Acara

Kembalikan BindableEvent yang ditembak setiap kali pemain diblokir oleh pemain lokal.

Acara Terbuka Pemain

Kembalikan BindableEvent yang ditembak setiap kali pemain diblokir oleh pemain lokal.

Acara Pemutusan Pemain

Kembalikan BindableEvent yang ditembak setiap kali pemain dimatikan oleh pemain lokal.

Acara Pemutusan Pemain

Kembalikan BindableEvent yang ditembak setiap kali pemain dimatikan oleh pemain lokal.

Acara Teman Pemain

Kembalikan BindableEvent yang ditembak setiap kali pemain dijadikan teman oleh pemain lokal.

Peristiwa Pemain Tak Teman

Kembalikan BindableEvent yang ditembak setiap kali pemain dihapus oleh pemain lokal.

Devconsole Terlihat *

Kembalikan true jika Konsol Pengembang terlihat.

VRRotasi Intensitas

Kembalikan string yang menggambarkan sensitivitas rotasi kamera di VR: Low , High dan Smooth .Ini tidak akan tersedia kecuali VRService.VREnabled adalah true .

Parameter

parameterName: string
Nilai Default: ""

Memberikan nilai

Variant

Acara