StarterGui

Artık kullanılmayanları göster

*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.

Oluşturulamaz
Hizmet

StarterGui bir konteyner nesnesi, LayerCollector gibi nesneleri tutmak üzere tasarlanmıştır ScreenGuis .

Bir Player.Character oluştuğunda, içerikleri PlayerGui (varsa) boşaltılır.StarterGui çocuklarının torunlarıyla birlikte kopyalanması gerekir PlayerGui .Ancak, nesnelerin, özellik setleriyle bir oyuncunun içine yerleştirileceğini ve yeniden doğduğunda silinmeyeceğini unutmayın.

StarterGui ayrıca CoreGui ile etkileşime girebilmenizi sağlayan bir dizi işlev içerir.Örneğin StarterGui:SetCoreGuiEnabled() , CoreGui 'in elemanlarını devre dışı bırakmak için kullanılabilir ve StarterGui:SetCore() , bildirimler ve sistem mesajları oluşturma dahil olmak üzere çeşitli işlevler yerine getirebilir.

Özet

Özellikler

Şuradan alınanların tümünü görüntüle: Instance
Şuradan alınanların tümünü görüntüle: Object

Yöntemler

Şuradan alınan Yöntemler: BasePlayerGui
Şuradan alınanların tümünü görüntüle: Instance
Şuradan alınanların tümünü görüntüle: Object

Özellikler

ProcessUserInput

boolean
Gizli
Çoğaltılmamış
Eklenti Güvenliği
Paralel oku

StarterGui girişi PlayerGui ve CoreGui gibi işlemesine izin verir.Varsayılan değer false dir.

RtlTextSupport

Enum.RtlTextSupport
Betiklenemez
Paralel oku

ScreenOrientation

Enum.ScreenOrientation
Paralel oku

Bu özellik, mobil cihazlara sahip kullanıcılar için tercih edilen ekran yönlendirme modunu ayarlar. Hangi modlar mevcutsa, bakın Enum.ScreenOrientation .

Varsayılan olarak, bu özellik Sensor olarak ayarlanır, yani deneyim, cihazın mevcut yönüne bağlı olarak görüntülenir, ya da manzara (sol/sağ) ya da portre.

Bir Player bir mobil cihazda deneyime katıldığında, bu özellik cihazın başlangıç ​​yerini belirler ve o oyuncunun PlayerGui.ScreenOrientation 'sını buna göre ayarlar.Ayrıca oyuncunun mevcut ekran yönünü PlayerGui.CurrentScreenOrientation aracılığıyla alabilirsiniz, " sensör " Enum.ScreenOrientation ayarlarından birini kullanırken yararlıdır.

Bu özelliği değiştirmenin deneyimde zaten ekran yönünü değiştirmeyeceğini unutmayın Players .Mevcut bir oyuncunun yönünü değiştirmek için, onların PlayerGui.ScreenOrientation özelliklerini kullanın.

ShowDevelopmentGui

boolean
Paralel oku

Bu özellik, StarterGui içeriğinin Studio'da görülebilir olup olmadığını belirler.

VirtualCursorMode

Enum.VirtualCursorMode
Betiklenemez
Paralel oku
Şuradan alınanların tümünü görüntüle: Instance
Şuradan alınanların tümünü görüntüle: Object

Yöntemler

GetCoreGuiEnabled

boolean

Bu işlev, verilen Enum.CoreGuiType 'nin etkinleştirildiğini veya StarterGui:SetCoreGuiEnabled() kullanarak devre dışı bırakıldığını döndürür.Bu işlev müşteride çağrılmalıdır.

Ayarları "TopbarEnabled"``false``Class.StarterGui:SetCore()|SetCore() kullanarak ayarlamak, tüm CoreGuiTypes gizler, ancak bu işlevin sonucunu etkilemez.

Parametreler

coreGuiType: Enum.CoreGuiType

Verdiğin Enum.CoreGuiType .

Varsayılan değer: ""

Dönüşler

boolean

Verilen Enum.CoreGuiType etkinleştirilmiş olup olmadığı.

Kod Örnekleri

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

()

Bu yöntem (Roblox'un temel kodlarıyla karıştırılmamalıdır SetCoreGuiEnabled()) Roblox'un çekirdek kodları tarafından tanımlanan çeşitli işlevleri açığa çıkarır, örneğin bildirim göndermek, rozetler/puanlar için bildirimleri değiştirmek, sıfırlama düğmesi için bir geri çağrı yapmak veya üst çubuğu değiştirmek.

İlk parametre, çağrının etkileşime gireceği işlevi seçen bir dize.Eşit çekirdek kodun henüz yüklenmediği veya tümüyle devre dışı bırakıldığı durumda, bu yöntemi pcall() kullanarak birden fazla kez çağırmak gerekebilir.

Aşağıdaki tablo, ilk parametre olarak kabul edilebilecek dizeyi tanımlar.Takip edilmesi gereken parametler, kullanılacak işlevselliklere bağlıdır ve alt tablolarda açıklanır.

Sohbet Aktif

Sohbetin aktif olup olmadığını kontrol eder.

<th>Tür</th>



    <th>Varsayılan</th>



    <th>Açıklama</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>etkin</code></td>



    <td>boşluklı</td>



    <td>(gerekli)</td>



    <td>Sohbetin aktif olması gereip geremediğini belirler.</td>

  </tr>

</tbody>
Adı
Nokta BildirimleriAktif

Kazanılan oyuncu puanları için bildirimlerin görünecek olup olmadığını kontrol eder.

<th>Tür</th>



    <th>Varsayılan</th>



    <th>Açıklama</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>etkin</code></td>



    <td>boşluklı</td>



    <td>(gerekli)</td>



    <td>Kazanılan oyuncu puanları için bildirimlerin görüneceğini belirler.</td>

  </tr>

</tbody>
Adı
RozetlerNotifikasyonlarAktif

Kazanılan rozetler için bildirimlerin görünecek olup olmadığını kontrol eder.

<th>Tür</th>



    <th>Varsayılan</th>



    <th>Açıklama</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>etkin</code></td>



    <td>boşluklı</td>



    <td>(gerekli)</td>



    <td>Kazanılan rozetler için bildirimlerin görünecek olup olmadığını belirler.</td>

  </tr>

</tbody>
Adı
Sıfırlama Düğmesi ÇağrısıYeniden düzenleButtonCallback

Bir oyuncu sıfırlama isteğinde bulunduğunda ateşlenmesi gereken bir sıfırlama düğmesinin, eğer varsa, davranışını belirler BindableEvent .

<th>Tür</th>



    <th>Varsayılan</th>



    <th>Açıklama</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>etkinleştirildi</code></td>



    <td>boşluklı</td>



    <td>(gerekli)</td>



    <td>Sıfırlama düğmesinin varsayılan davranışını koruduğunu belirler.</td>

  </tr>



  <tr>

    <td colspan="4"><b>OR</b></td>

  </tr>



  <tr>

    <td><code>geri çağrı</code></td>



    <td><code>Sınıf.BindableEvent</code></td>



    <td>(gerekli)</td>



    <td>Oyuncu sıfırlamak istediğini onayladığında ateşlenecek bir <code>Class.BindableEvent</code> sınıfı.</td>

  </tr>

</tbody>
Adı
SohbetSistemMesajıYapma

Sohbette biçimlendirilmiş bir mesaj görüntüle.Bu yöntemi kullanmak, miras sohbetin bırakılmasına rağmen deneyimin olarak ayarlanmasını gerektirir, ancak kullanım teşvik edilmez.Mevcut TextChatService kullanan deneyimler için, TextChannel:DisplaySystemMessage() 'a bakın.

<th>Tür</th>



    <th>Varsayılan</th>



    <th>Açıklama</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>configTable

    Yorumlar

    Yorumlar

    Tartışma:configTable</code></td>



    <td>sözlük</td>



    <td>(gerekli)</td>



    <td>Mesajı tanımlayan bir bilgi sözlüğü (aşağıya bakın).</td>

  </tr>

</tbody>
Adı
<th>Tür</th>



    <th>Varsayılan</th>



    <th>Açıklama</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>Tekst</code></td>



    <td>dizi</td>



    <td>(gerekli)</td>



    <td>Görüntülenecek mesaj.</td>

  </tr>



  <tr>

    <td><code>Rengi</code></td>



    <td><code>Veri Türü.Renk3</code></td>



    <td><code>Veri türü.Color3.fromRGB(255, 255, 243)</code></td>



    <td>mesajmetin rengi.</td>

  </tr>



  <tr>

    <td><code>Yazı Tipi</code></td>



    <td><code>Enum.Font

    Yorumlar

    Türkçe:Enum.Font</code></td>



    <td><code>KaynakSansBold</code></td>



    <td>mesajyazı tipi.</td>

  </tr>



  <tr>

    <td><code>Metin Boyutu</code></td>



    <td>sayısal</td>



    <td><code>18</code></td>



    <td>mesajmetin boyutu.</td>

  </tr>

</tbody>
Adı
Bildirim gönder

Ekranın sağ altında görünmeyen bir bildirim oluşturur. Bildirimin iki düğmesine kadar olabilir.

<th>Tür</th>



    <th>Varsayılan</th>



    <th>Açıklama</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>configTable

    Yorumlar

    Yorumlar

    Tartışma:configTable</code></td>



    <td>sözlük</td>



    <td>(gerekli)</td>



    <td>Bildirimi tanımlayan bir bilgi sözlüğü (aşağıya bakın).</td>

  </tr>

</tbody>
Adı
<th>Tür</th>



    <th>Varsayılan</th>



    <th>Açıklama</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>BAŞLIK</code></td>



    <td>dizi</td>



    <td>(gerekli)</td>



    <td>bildirim.</td>

  </tr>



  <tr>

    <td><code>Tekst</code></td>



    <td>dizi</td>



    <td>(gerekli)</td>



    <td>Bildirimin ana metni.</td>

  </tr>



  <tr>

    <td><code>Simge</code></td><td>dize</td>



    <td />



    <td>Bildirimle görüntülenecek bildirim.</td>

  </tr>



  <tr>

    <td><code>Süre</code></td>



    <td>sayı</td>



    <td><code>5</code></td>



    <td>Bildirimin (saniyeler içinde) görünür kalması gereken süre.</td>

  </tr>



  <tr>

    <td><code>Geri çağrı</code></td><td><code>Sınıf.BindableFunction</code></td>



    <td />



    <td>oyuncutarafından basılan düğmenin metni ile çağrılması gereken bir <code>Class.BindableFunction</code> sınıfı.</td>

  </tr>



  <tr>

    <td><code>Düğme1</code></td><td>dize</td>



    <td />



    <td>İlk düğmeye görüntülenecek metin.</td>

  </tr>



  <tr>

    <td><code>Düğme2</code></td><td>dize</td>



    <td />



    <td>İkinci düğmeye görüntülenecek metin.</td>

  </tr>

</tbody>
Adı
Üst çubuk etkinleştirildi

Üst çubuğun görüntülenip görüntülenmediğini belirler.Üst çubuğu devre dışı bırakmak, sohbet, envanter ve oyuncu listesi gibi tüm CoreGuis özellikleri devre dışı bırakacaktır (örneğin, SetCoreGuiEnabled ile ayarlananlar).

Devre dışı bırakıldığında, çubuğun bir kez işgal ettiği bölge hala fare olaylarını yakalayacaktır; ancak orada yerleştirilen düğmeler tıklamalara yanıt vermeyecektir.GUI alanının kökeni hala ekranın üstünden 36 piksel ofset edilecektir.

<th>Tür</th>



    <th>Varsayılan</th>



    <th>Açıklama</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>etkinleştirildi</code></td>



    <td>boşluklı</td>



    <td>(gerekli)</td>



    <td>Üst çubuğun görünür olup olmadığını belirler.</td>

  </tr>

</tbody>
Adı
Görünür KonsolGörünür KonsolDevConsoleVisible

Geliştirici Konsolu'nun görülebilir olup olmadığını belirler.

<th>Tür</th>



    <th>Varsayılan</th>



    <th>Açıklama</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>görünürlük</code></td>



    <td>boşluklı</td>



    <td>(gerekli)</td>



    <td>Konsolun görülebilir olup olmadığını belirler.</td>

  </tr>

</tbody>
Adı
Hemen Arkadaş İsteği Gönder

Mevcut oyuncudan, verilen Player 'a bir arkadaş isteği göndermesini ister.

<th>Tür</th>



    <th>Varsayılan</th>



    <th>Açıklama</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>oyuncu</code></td>



    <td><code>Sınıf.Oyuncu</code></td>



    <td>(gerekli)</td>



    <td>Arkadaş isteğinin gönderilmesi gereken oyuncu.</td>

  </tr>

</tbody>
Adı
Arkadaşını Hatırlat PromptUnfriend

Mevcut oyuncuya, arkadaşları listesinden belirli bir Player kaldırmasını istemektedir.

<th>Tür</th>



    <th>Varsayılan</th>



    <th>Açıklama</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>oyuncu</code></td>



    <td><code>Sınıf.Oyuncu</code></td>



    <td>(gerekli)</td>



    <td>Arkadaş olmaması gereken oyuncu.</td>

  </tr>

</tbody>
Adı
HızlıBlokOynatıcı

Mevcut oyuncuya verilen Player engellemeyi engellemesini ister.

<th>Tür</th>



    <th>Varsayılan</th>



    <th>Açıklama</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>oyuncu</code></td>



    <td><code>Sınıf.Oyuncu</code></td>



    <td>(gerekli)</td>



    <td>Engellenmesi gereken oyuncu.</td>

  </tr>

</tbody>
Adı
PromptUnblockPlayer'ı aç

Mevcut oyuncuya verilen Player 'nin kilidini açmasını ister.

<th>Tür</th>



    <th>Varsayılan</th>



    <th>Açıklama</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>oyuncu</code></td>



    <td><code>Sınıf.Oyuncu</code></td>



    <td>(gerekli)</td>



    <td>Kilidi açılması gereken oyuncu.</td>

  </tr>

</tbody>
Adı
AvatarKonteks MenüsüAçık

Avatar Konu Menüsünün etkin olup olmadığını belirler.

<th>Tür</th>



    <th>Varsayılan</th>



    <th>Açıklama</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>etkinleştirildi</code></td>



    <td>boşluklı</td>



    <td>(gerekli)</td>



    <td>Kontekst menünün etkinleştirilip etkinleştirilmediğini belirler.</td>

  </tr>

</tbody>
Adı
AvatarKonuMenüHedefi

Zorla Avatar Bağlantı Menüsü açar.

<th>Tür</th>



    <th>Varsayılan</th>



    <th>Açıklama</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>oyuncu</code></td>



    <td><code>Sınıf.Oyuncu</code></td>



    <td>(gerekli)</td>



    <td>Kontekst menüsünün açılacağı oyuncu.</td>

  </tr>

</tbody>
Adı
AddAvatarContextMenuOption seçeneği

Avatar Bağımsız Mod Menüsü 'ye bir seçenek ekler.

<th>Tür</th>



    <th>Varsayılan</th>



    <th>Açıklama</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>seçenek</code></td>



    <td><code>Enum.AvatarContextMenuOption seçeneği</code></td>



    <td>(gerekli)</td>



    <td>Ekleme ekle.</td>

  </tr>



  <tr>

    <td colspan="4"><b>OR</b></td>

  </tr>



  <tr>

    <td><code>seçenek</code></td>



    <td>tablo</td>



    <td>(gerekli)</td>



    <td>Bir iki elemanlı tablo, ilki özel aksiyonadıdır ve ikincisi oyuncu ile ateşlenecek bir <code>Class.BindableEvent</code> sınıfıdır, seçeneğin etkinleştirildiğinde.</td>

  </tr>

</tbody>
Adı
AvatarKonteksMenüSeçeneğiniKaldır

Avatar Bağlantı Menüsü 'ne bir seçenek kaldırır. option argümanı, "AddAvatarContextMenuOption" ile kullanılanla aynı olmalıdır (yukarıya bakın).

<th>Tür</th>



    <th>Varsayılan</th>



    <th>Açıklama</th>

  </tr>

</thead>



<tbody>

  <tr>

    <td><code>seçenek</code></td>



    <td>Değişken</td>



    <td>(gerekli)</td>



    <td>Aynı değer <b>AddAvatarContextMenuOption</b> 'a verildi.</td>

  </tr>

</tbody>
Adı
AvatarKonteksMenüTeması

Özelleştirilebilir Avatar Bağlantı Menüsünü yapılandırır, ki bu bir seçme özelliğidir ve özelleştirilmiş eylemlerle kolay oyuncu-oyuncu sosyal etkileşimine izin verir, örneğin takasları başlatmak, savaşlar ve daha fazlası.Temasını nasıl özelleştireceğinizle ilgili daha fazla bilgi için, Avatar Bağlantı Menüsü makalesine bakın.

ÇekirdekGuiChatConnections

CoreGui üstbilgisinin sohbet düğmesi ve miras sohbet sistemi arasında bağlanabilir bir yolcu bağlantısı kurur.İkinci parametre BindableEvents ve BindableFunctions tablosu olmalıdır.

Parametreler

parameterName: string

Çağrının etkileşime gireceği işlevi seçer.

Varsayılan değer: ""
value: Variant

Bir tablo BindableEvents ve BindableFunctions.

Varsayılan değer: ""

Dönüşler

()

Kod Örnekleri

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

()

Bu işlev, verilen CoreGui öğesine bağlı Enum.CoreGuiType elemanın etkinleştirilip etkinleştirilmediğini ayarlar.

Üst çubuk bu işlev kullanılarak devre dışı bırakılamaz. Devre dışı bırakmak için, kullanarak ayarlanır.

Parametreler

coreGuiType: Enum.CoreGuiType

Verdiğin Enum.CoreGuiType .

Varsayılan değer: ""
enabled: boolean

Verilen Enum.CoreGuiType 'yi etkinleştirmek veya devre dışı bırakmak.

Varsayılan değer: ""

Dönüşler

()

GetCore

Variant
Bekletir

Bu yöntem, Roblox'un çekirdek kodları tarafından sağlanan veya kullanılan veri setini döndürür.İlk ve tek değer, alınacak bilgileri seçen bir dize.Aşağıdaki bölümler, bu işlev tarafından döndürülen dize ve verileri tanımlar.

Bu yöntemi çağırmak verebilir. Bunların çoğu da eşdeğer bir SetCore() fonksiyonu kaydediyor (bunlar bir yıldızla işaretleniyor).

Nokta BildirimleriAktif *

Oyuncu nokta bildirimleri etkinleştirilmişse true döndürür.

RozetlerNotifikasyonlarAktif *

Eğer rozet bildirimleri etkinleştirilmişse true döndürür.

AvatarKonteksMenüsüAktif *

Eğer Avatar Bağlantı Menüsü etkinleştirilmişse true.

SohbetAktif*

Sohbetin aktif olup olmadığını döndürür. Bu, üst çubuğun sohbet simgesinin seçim durumu tarafından belirtilir.

Sohbet Pencere Boyutu *

Sohbet penceresinin boyutunu UDim2 olarak döndürür.

Sohbet Penceresi Konumu *

Sohbet penceresinin boyutunu UDim2 olarak döndürür.

Sohbet Çubuğu Kapalı *

Sohbet çubuğu devre dışı bırakıldığında true döndürür.

GetBlockedUserIds alın

Yerel oyuncu tarafından engellenen kullanıcılarla ilişkili bir liste UserIds döndürür.

Oyuncu engellenmiş etkinlik

Bir oyuncu yerel oyuncu tarafından engellendiğinde her seferinde ateşlenen bir BindableEvent döndürür.

OyuncuKilidiAçılanEtkinlik

Bir oyuncu yerel oyuncu tarafından engellenmediğinde her zaman ateşlenen bir BindableEvent döndürür.

OyuncuSessiz Etkinlik

Bir oyuncu yerel oyuncu tarafından susturulduğunda her seferinde ateşlenen bir BindableEvent döndürür.

OyuncuSessiz Etkinlik

Bir oyuncu yerel oyuncu tarafından kapatıldığında her seferinde ateşlenen bir BindableEvent döndürür.

OyuncuArkadaşıEtkinlik

Bir oyuncu yerel oyuncu tarafından arkadaş edildiğinde herhangi bir BindableEvent geri döndürür, ki bu her oyuncu için geçerlidir.

OyuncuArkadaşsızEtkinlik

Bir oyuncu yerel oyuncu tarafından arkadaşsız bırakıldığında herhangi bir BindableEvent geri döndürür, herhangi bir oyuncuya arkadaş olmayı bırakır.

Görünen Geliştirici Konsolu *

Görüntülenebilirse trueGeliştirici Konsolu görünürse döndürür.

VRRotasyonIntensitesi

VR'de kamera dönme hassasiyetini tanımlayan bir dize döndürür: Low , High ve Smooth .Bunun kullanılabilir olması için olmalıdır.

Parametreler

parameterName: string
Varsayılan değer: ""

Dönüşler

Variant
Şuradan alınanların tümünü görüntüle: Instance
Şuradan alınanların tümünü görüntüle: Object

Etkinlikler

Şuradan alınanların tümünü görüntüle: Instance
Şuradan alınanların tümünü görüntüle: Object