StarterGui
*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.
StarterGui adalah objek kontainer yang dirancang untuk menampung LayerCollector objek seperti ScreenGuis .
StarterGui juga termasuk berbagai fungsi yang memungkinkan Anda untuk berinteraksi dengan CoreGui . Misalnya StarterGui:SetCoreGuiEnabled() dapat digunakan untuk menonaktifkan elemen dari 0> Class.CoreGui0> ,
Rangkuman
Properti
Memungkinkan layanan ini untuk memproses input seperti PlayerGui dan CoreGui melakukannya.
Tetapkan mode orientasi layar default untuk pengguna dengan perangkat mobile.
Menentukan apakah konten StarterGui terlihat di Studio.
Metode
Mengembalikan apakah Enum.CoreGuiType yang diberikan diaktif, atau jika telah dinonaktifkan menggunakan StarterGui:SetCoreGuiEnabled() .
Memungkinkan Anda untuk melakukan interaksi tertentu dengan script inti Roblox.
Tetapkan apakah elemen CoreGui yang terkait dengan Enum.CoreGuiType yang diberikan diaktif atau tidak.
Mengembalikan variabel yang telah ditentukan oleh naskah inti Roblox.
Mengembalikan daftar semua GuiObject instans yang mengambil titik yang diberikan di layar.
Properti
ProcessUserInput
Memungkinkan StarterGui untuk memproses input seperti PlayerGui dan CoreGui melakukannya.Nilai default adalah 1> false1> .
RtlTextSupport
ScreenOrientation
Item ini menetapkan mode orientasi layar yang diinginkan untuk pengguna dengan perangkat seluler. Untuk mode yang tersedia, lihat Enum.ScreenOrientation.
Secara default, property ini diatur menjadi Sensor, yang berarti pengalaman ditampilkan tergantung pada kesesuaian terbaik dengan orientasi perangkat, baik horizontal (kiri/kanan) atau potret.
Ketika Player bergabung dengan pengalaman di perangkat seluler, orientasi pemula perangkat menentukan arah pemula perangkat dan menetapkan orientasi pemain tersebut sesuai. Anda juga dapat mengambil orientasi layar pemain melalui PlayerGui.ScreenOrientation, yang berg
Catat bahwa mengubah propperti ini tidak akan mengubah orientasi layar untuk Players di dalam pengalaman. Untuk mengubah orientasi untuk pemain yang sudah ada, gunakan propperti mereka PlayerGui.ScreenOrientation .
VirtualCursorMode
Metode
GetCoreGuiEnabled
Fungsi ini menentukan apakah Enum.CoreGuiType yang diberikan diaktif, atau apakah itu telah dinonaktifkan menggunakan StarterGui:SetCoreGuiEnabled() . Fungsi ini harus dipanggil di klien.
Catat bahwa mengatur >TopbarEnabled" menjadi false" menggunakan Class.StarterGui:SetCore()|SetCore() menyembunyikan semua 1> Class.CoreGuiType|CoreGuiTypes1> tetapi tidak mengubah hasil dari fungsi ini.
Parameter
CoreGuiType yang diberikan.
Memberikan nilai
Apakah Enum.CoreGuiType yang diberikan diaktifkan.
Contoh Kode
local StarterGui = game:GetService("StarterGui")
print(StarterGui:GetCoreGuiEnabled("PlayerList"))
SetCore
Metode ini (bukan untuk dibingungkan dengan SetCoreGuiEnabled() ) mengekspos berbagai fungsionalitas yang ditentukan oleh naskah inti Roblox, seperti mengirim notifikasi, mengubah notifikasi untuk badge/poin, menentukan panggilan untuk tombol reset, atau mengubah tombol atas.
Parameter pertama adalah string yang memilih fungsionalitas dengan mana panggilan akan berinteraksi. Mungkin perlu untuk memanggil metode ini beberapa kali menggunakan pcall() di kasus script core yang belum dimuat (atau jika itu telah dinonaktifkan sepenuhnya).
Tabel berikut menjelaskan string yang dapat diterima sebagai parameter pertama. Para parameter yang harus diikuti bergantung pada fungsionalitas yang akan digunakan dan dijelaskan dalam sub-tabel.
ObrolanAktif
Mengontrol apakah obrolan aktif.
<tbody><tr><td><code>aktif</code></td><td>boolean</td><td>(diperlukan)</td><td>Menentukan apakah obrolan harus aktif.</td></tr></tbody>
Nama | Jenis | Standar | Deskripsi |
---|
Notifikasi Titik Aktif
Mengontrol apakah notifikasi untuk poin pemain yang diperoleh akan muncul.
<tbody><tr><td><code>aktif</code></td><td>boolean</td><td>(diperlukan)</td><td>Menentukan apakah notifikasi untuk poin pemain yang diperoleh akan muncul.</td></tr></tbody>
Nama | Jenis | Standar | Deskripsi |
---|
BadgeNotifikasiAktif
Mengontrol apakah notifikasi untuk badge yang diperoleh akan muncul.
<tbody><tr><td><code>aktif</code></td><td>boolean</td><td>(diperlukan)</td><td>Menentukan apakah notifikasi untuk badge yang diperoleh akan muncul.</td></tr></tbody>
Nama | Jenis | Standar | Deskripsi |
---|
Kurungan Tombol
Menentukan perilaku, jika ada, dari tombol reset yang diberikanBoolean atau BindableEvent untuk dijatuhkan ketika seorang pemain meminta untuk mengatur ulang.
<tbody><tr><td><code>diaktifkan</code></td><td>boolean</td><td>(diperlukan)</td><td>Menentukan apakah tombol reset menyimpan perilaku defaultnya.</td></tr><tr><td colspan="4"><b>ATAU</b></td></tr><tr><td><code>panggilan kembali</code></td><td><code>Klas.BindableEvent</code></td><td>(diperlukan)</td><td>Sebuah <code>Class.BindableEvent</code> untuk dijatuhkan saat pemain mengkonfirmasi bahwa mereka ingin reset.</td></tr></tbody>
Nama | Jenis | Standar | Deskripsi |
---|
Pesan Teks
Tampilkan pesan yang dibentuk dalam chat.
<tbody><tr><td><code>configMeja</code></td><td>dictionary</td><td>(diperlukan)</td><td>Sebuah kamus informasi yang menggambarkan pesan (lihat di bawah).</td></tr></tbody>
Nama | Jenis | Standar | Deskripsi |
---|
<tbody><tr><td><code>Teks</code></td><td>string</td><td>(diperlukan)</td><td>Pesan untuk ditampilkan.</td></tr><tr><td><code>Warna</code></td><td><code>Datatype.Color3</code></td><td><code>Datatype.Color3.fromRGB(255, 255, 243)</code></td><td>Warna teks pesan.</td></tr><tr><td><code>Huruf</code></td><td><code>Font.</code></td><td><code>SourceSansBold</code></td><td>Font pesan.</td></tr><tr><td><code>Ukuran Teks</code></td><td>float</td><td><code>18.</code></td><td>Ukuran teks pesan.</td></tr></tbody>
Nama | Jenis | Standar | Deskripsi |
---|
Kirim Pengumuman
Mengaktifkan notifikasi yang tidak mengganggu untuk muncul di bagian bawah kanan layar. Notifikasi mungkin memiliki hingga dua tombol.
<tbody><tr><td><code>configMeja</code></td><td>dictionary</td><td>(diperlukan)</td><td>Sebuah kamus informasi yang menggambarkan pengumuman (lihat di bawah).</td></tr></tbody>
Nama | Jenis | Standar | Deskripsi |
---|
<tbody><tr><td><code>Judul</code></td><td>string</td><td>(diperlukan)</td><td>Judul notifikasi.</td></tr><tr><td><code>Teks</code></td><td>string</td><td>(diperlukan)</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>nomor</td><td><code>5</code></td><td>Durasi (dalam detik) notifikasi harus tetap terlihat.</td></tr><tr><td><code>Panggilan Kembali</code></td><td><code>Klas.BindableFunction</code></td><td /><td>A <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>Tombol 2</code></td><td>string</td><td /><td>Teks untuk ditampilkan pada tombol kedua.</td></tr></tbody>
Nama | Jenis | Standar | Deskripsi |
---|
Topbar Diaktifkan
Menentukan apakah bilah atas ditampilkan. Menonaktifkan bilah atas juga akan menonaktifkan semua CoreGuis seperti chat, inventaris, dan daftar pemain (untuk contoh, mereka yang ditetapkan dengan SetCoreGuiEnabled).
Ketika dinonaktifkan, bilah atas akan segera menangkap acara mouse; namun, tombol yang ditempatkan di sana tidak akan merespon klik. Orang asli ruang GUI akan tetap 36 pixel dari bagian atas layar.
<tbody><tr><td><code>diaktifkan</code></td><td>boolean</td><td>(diperlukan)</td><td>Menentukan apakah bilah atas harus terlihat.</td></tr></tbody>
Nama | Jenis | Standar | Deskripsi |
---|
DevConsoleTerlihat
Menentukan apakah Developer Console terlihat.
<tbody><tr><td><code>kejelasan</code></td><td>boolean</td><td>(diperlukan)</td><td>Menentukan apakah konsolnya terlihat.</td></tr></tbody>
Nama | Jenis | Standar | Deskripsi |
---|
MintaTeman
Mendesak pemain saat ini untuk mengirim permintaan teman ke Player yang diberikan.
<tbody><tr><td><code>pemain</code></td><td><code>Klas.Player</code></td><td>(diperlukan)</td><td>Pemain ke mana permintaan teman harus dikirim.</td></tr></tbody>
Nama | Jenis | Standar | Deskripsi |
---|
TawarkanTeman
Mendesak pemain saat ini untuk menghapus Player dari daftar teman mereka.
<tbody><tr><td><code>pemain</code></td><td><code>Klas.Player</code></td><td>(diperlukan)</td><td>Pemain yang harus di-unfriend.</td></tr></tbody>
Nama | Jenis | Standar | Deskripsi |
---|
Pemutar Blok Prompt
Menginstruksikan pemain saat ini untuk menolak Player yang diberikan.
<tbody><tr><td><code>pemain</code></td><td><code>Klas.Player</code></td><td>(diperlukan)</td><td>Pemain yang harus diblokir.</td></tr></tbody>
Nama | Jenis | Standar | Deskripsi |
---|
Pemutar Blok Prompt
Mendesak pemain saat ini untuk membuka blokir Player yang diberikan.
<tbody><tr><td><code>pemain</code></td><td><code>Klas.Player</code></td><td>(diperlukan)</td><td>Pemain yang seharusnya tidak diblokir.</td></tr></tbody>
Nama | Jenis | Standar | Deskripsi |
---|
Avatar Konteks MenuDiaktifkan
Mengidentifikasi apakah Menu Konteks Avatar diaktifkan.
<tbody><tr><td><code>diaktifkan</code></td><td>boolean</td><td>(diperlukan)</td><td>Mengeset apakah menu konteks diaktifkan.</td></tr></tbody>
Nama | Jenis | Standar | Deskripsi |
---|
MenuTargetKonteks Avatar
Menggunakan force untuk membuka Menu Konteks Avatar .
<tbody><tr><td><code>pemain</code></td><td><code>Klas.Player</code></td><td>(diperlukan)</td><td>Pemain di mana menu konteks akan dibuka.</td></tr></tbody>
Nama | Jenis | Standar | Deskripsi |
---|
Tambahkan Opsi Menu Konteks Avatar
Menambahkan opsi ke Menu Konteks Avatar .
<tbody><tr><td><code>pilihan</code></td><td><code>Menu.AvatarContextMenuOption.</code></td><td>(diperlukan)</td><td>Opsi untuk tambah.</td></tr><tr><td colspan="4"><b>ATAU</b></td></tr><tr><td><code>pilihan</code></td><td>tabel</td><td>(diperlukan)</td><td>Tabel dua elemen, di mana yang pertama adalah nama actionkhusus, dan yang kedua adalah <code>Class.BindableEvent</code> yang akan diaktifkan dengan pemain yang dipilih saat opsi diaktifkan.</td></tr></tbody>
Nama | Jenis | Standar | Deskripsi |
---|
Hapus Menu Konteks Avatar
Menghapus opsi dari Menu Konteks Avatar . $option argument harus sama dengan apa yang digunakan dengan option (melihat di atas).
<tbody><tr><td><code>pilihan</code></td><td>Varian</td><td>(diperlukan)</td><td>Nilai yang sama diberikan kepada <b>Tambahkan Menu Konteks Avatar</b>.</td></tr></tbody>
Nama | Jenis | Standar | Deskripsi |
---|
Menu Tema Avatar
Mengonfigurasi Menu Konteks Avatar yang Dapat Diubah yang merupakan fitur opt-in yang memungkinkan interaksi sosial antara pemain dengan mudah melalui tindakan khusus, seperti memulai perdagangan, pertempuran, dan banyak lagi. Untuk informasi lebih lanjut tentang cara menyesuaikan temanya, lihat artikel Menu Konteks Avatar.
Koneksi CoreGuiChat
Mengatur koneksi gateway yang dapat dipasang antara tombol obrolan CoreGui dan sistem obrolan legendaris. Anggota kedua harus menjadi tabel BindableEvents dan BindableFunctions.
Parameter
Memilih fungsionalitas dengan mana panggilan akan berinteraksi.
Tabel dari BindableEvents dan BindableFunctions .
Memberikan nilai
Contoh Kode
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 diaktif atau dinonaktifkan.
Top bar tidak dapat dinonaktifkan menggunakan fungsi ini. Untuk menonaktifkannya, set "TopbarEnabled" menjadi false menggunakan StarterGui:SetCore() .
Parameter
CoreGuiType yang diberikan.
Apakah akan mengaktifkan atau menonaktifkan Enum.CoreGuiType yang diberikan.
Memberikan nilai
GetCore
Metode ini mengembalikan set data atau tersedia oleh skrip inti Roblox. Parameter pertama dan hanya adalah string yang memilih informasi untuk diambil. Bagian berikutnya menggambarkan string dan data yang dikembalikan oleh fungsi ini.
Memanggil metode ini dapat menghasilkan. Banyak dari ini juga mendaftarkan fungsi serupa SetCore() (yang disorot dengan asterisk).
Notifikasi Titik *
Mengembalikan true jika notifikasi poin pemain diaktifkan.
BadgesNotificationsAktif *
Mengembalikan true jika notifikasi badge diaktifkan.
AvatarContextMenuEnabled *
Mengembalikan true jika Avatar Konteks Menu diaktifkan.
ObrolanAktif*
Mengembalikan apakah obrolan aktif atau tidak. Ini ditunjukkan oleh status pemilihan ikon obrolan di bagian atas bilah.
UkuranJendelaObrolan *
Mengembalikan ukuran jendela chat sebagai UDim2 .
PosisiJendelaObrolan *
Mengembalikan ukuran jendela chat sebagai UDim2 .
ChatBarDisabled *
Mengembalikan true jika bilah chat dinonaktifkan.
DapatkanBlockedUserIds
Mengembalikan daftar UserIds yang terkait dengan pengguna yang telah diblokir oleh pemain lokal.
Acara Diblokir Pemain
Mengembalikan Class.BindableEvent yang diblokir setiap kali seorang pemain diblokir oleh pemain lokal.
Acara Pemain Tidak Diblokir
Mengembalikan Class.BindableEvent yang dibawa kembali setiap kali seorang pemain dibuka kembali oleh pemain lokal.
Acara Pemutar
Mengembalikan Class.BindableEvent yang dibawa kembali setiap kali seorang pemain dimute oleh pemain lokal.
Acara Pemutar Tidak Diputar Ulang
Mengembalikan Class.BindableEvent yang dibawa kembali setiap kali seorang pemain diunmuted oleh pemain lokal.
Acara Pemain
Mengembalikan Class.BindableEvent yang dibangun setiap kali seorang pemain berteman dengan pemain lokal.
Acara Pemain yang Tidak Dikenal
Mengembalikan Class.BindableEvent yang dibawa kembali setiap kali seorang pemain di-unfriend dari pemain lokal.
DevConsoleVisible *
Mengembalikan true jika Developer Console terlihat.
Kecepatan Rotasi
Mengembalikan string yang menggambarkan sensitivitas rotasi kamera dalam VR: Low, High, dan Smooth. Ini tidak akan tersedia kecuali jika 2>Class.VRService.VREnabled2> adalah 5>true5>.