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 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

Metode

Metode diwarisi dari BasePlayerGui

Properti

ProcessUserInput

Tersembunyi
Tidak Direplikasi
Keamanan Plugin
Baca Paralel

Memungkinkan StarterGui untuk memproses input seperti PlayerGui dan CoreGui melakukannya.Nilai default adalah 1> false1> .

RtlTextSupport

Tidak Dapat Ditulis Skripnya
Baca Paralel

ScreenOrientation

Baca Paralel

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 .

ShowDevelopmentGui

Baca Paralel

Item ini menentukan apakah konten dari StarterGui terlihat di Studio.

VirtualCursorMode

Tidak Dapat Ditulis Skripnya
Baca Paralel

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: Enum.CoreGuiType

CoreGuiType yang diberikan.


Memberikan nilai

Apakah Enum.CoreGuiType yang diberikan diaktifkan.

Contoh Kode

Checking if a Core GUI is Enabled

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

SetCore

void

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>
NamaJenisStandarDeskripsi
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>
NamaJenisStandarDeskripsi
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>
NamaJenisStandarDeskripsi
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>
NamaJenisStandarDeskripsi
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>
NamaJenisStandarDeskripsi

<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>
NamaJenisStandarDeskripsi
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>
NamaJenisStandarDeskripsi

<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>
NamaJenisStandarDeskripsi
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>
NamaJenisStandarDeskripsi
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>
NamaJenisStandarDeskripsi
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>
NamaJenisStandarDeskripsi
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>
NamaJenisStandarDeskripsi
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>
NamaJenisStandarDeskripsi
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>
NamaJenisStandarDeskripsi
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>
NamaJenisStandarDeskripsi
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>
NamaJenisStandarDeskripsi
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>
NamaJenisStandarDeskripsi
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>
NamaJenisStandarDeskripsi
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

parameterName: string

Memilih fungsionalitas dengan mana panggilan akan berinteraksi.

value: Variant

Memberikan nilai

void

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

void

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: Enum.CoreGuiType

CoreGuiType yang diberikan.

enabled: bool

Apakah akan mengaktifkan atau menonaktifkan Enum.CoreGuiType yang diberikan.


Memberikan nilai

void

GetCore

Variant
Hasil

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>.

Parameter

parameterName: string

Memberikan nilai

Variant

Acara