StarterGui

Pozwala StarterGui przetwarzać wejście takie jak PlayerGui i CoreGui robić. Domyślną wartością jest false .

Właściwość ta ustawia preferowany tryb orientacji ekranu dla użytkowników z urządzeniami mobilnymi. Dla różnych dostępnych trybów patrz Enum.ScreenOrientation .

Domyślnie właściwość ta jest ustawiona na Sensor, co oznacza, że doświadczenie jest wyświetlane w zależności od najlepszego dopasowania do obecnego orientacji urządzenie, czyli poziomu (lewo/w prawo) lub portretu.

Kiedy Player dołącza do doświadczenia na urządzeniemobilnym, ta właściwość określa początkowe orientację urządzeniei ustawia odpowiednio gracza PlayerGui.ScreenOrientation.Możesz również uzyskać obecną orientację ekranu gracza za pośrednictwem PlayerGui.CurrentScreenOrientation, przydatną przy użyciu jednej z ustawień "czujnika" Enum.ScreenOrientation.

Zauważ, że zmiana tej właściwości nie zmieni orientacji ekranu dla Players już w doświadczeniu.Aby zmienić orientację dla istniejącego gracza, użyj jego właściwości PlayerGui.ScreenOrientation.

Właściwość ta określa, czy zawartość StarterGui jest widoczna w Studio.

Funkcja ta zwraca, czy dane Enum.CoreGuiType jest włączone, czy zostało wyłączone za pomocą StarterGui:SetCoreGuiEnabled() .Funkcja ta powinna być wywołana na klientzie.

Zauważ, że ustawienie "TopbarEnabled" do false za pomocą SetCore() ukrywa wszystkie CoreGuiTypes, ale nie wpływa na wynik tej funkcji.

Parametry

Zwroty

local StarterGui = game:GetService("StarterGui")

print(StarterGui:GetCoreGuiEnabled("PlayerList"))

Ta metoda (nie należy mylić z SetCoreGuiEnabled() ) ujawnia różnorodną funkcjonalność określoną przez główne skrypty Roblox, takie jak wysyłanie powiadomień, przełączanie powiadomień o odznakach/punktach, określenie powrotu za pomocą przycisku odnowienia lub przełączanie paska górnego.

Pierwszy parametr to ciąg znaków, który wybiera funkcjonalność, z którą wezwanie będzie interakcjonować.Może się okazać konieczne wezwanie tej metody wielokrotnie za pomocą pcall() w przypadku, gdy odpowiedni skrypt rdzenia nie został jeszcze załadowany (lub został wyłączony w całości).

Poniższa tabela opisuje struny, które mogą być zaakceptowane jako pierwszy parametr.Parametry, które powinny nastąpić, zależą od funkcjonalności, która zostanie użyta, i są opisane w tabelach podrzędnych.

Aktywny czat

Kontroluje, czy czat jest aktywny.

<th>Typ</th>

    <th>Domyślny</th>

    <th>Opis</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td><code>aktywny</code></td>

    <td>booleanowy</td>

    <td>(wymagane)</td>

    <td>Określa, czy czat powinien być aktywny.</td>
  </tr>
</tbody>

Powiadomienia o punktach aktywne

Kontroluje, czy pojawią się powiadomienia o zdobytych punktach gracza.

<th>Typ</th>

    <th>Domyślny</th>

    <th>Opis</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td><code>aktywny</code></td>

    <td>booleanowy</td>

    <td>(wymagane)</td>

    <td>Określa, czy pojawią się powiadomienia o zdobytych punktach gracza.</td>
  </tr>
</tbody>

OdznakiNotyfikacjeAktywne

Kontroluje, czy pojawią się powiadomienia o zdobytych odznakach.

<th>Typ</th>

    <th>Domyślny</th>

    <th>Opis</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td><code>aktywny</code></td>

    <td>booleanowy</td>

    <td>(wymagane)</td>

    <td>Określa, czy pojawią się powiadomienia o zdobytych odznakach.</td>
  </tr>
</tbody>

Przycisk odnowienia odpowiedzi

Określa zachowanie, jeśli istnieje, przycisku zresetowania, otrzymującego boolean lub BindableEvent gdy gracz żąda resetować.

<th>Typ</th>

    <th>Domyślny</th>

    <th>Opis</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td><code>włączone</code></td>

    <td>booleanowy</td>

    <td>(wymagane)</td>

    <td>Określa, czy przycisk zresetowania zachowuje domyślną zachowanie.</td>
  </tr>

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

  <tr>
    <td><code>callback</code></td>

    <td><code>Wydarzenie Class.BindableEvent</code></td>

    <td>(wymagane)</td>

    <td>Klasa <code>Class.BindableEvent</code>, która zostanie uruchomiona, gdy gracz potwierdzi, że chce zresetować.</td>
  </tr>
</tbody>

Wiadomość tworząca system czatu

Wyświetl formatowaną wiadomość w czacie.Użycie tej metody wymaga, aby doświadczenie TextChatService.ChatVersion było ustawione na LegacyChatService, chociaż starszy czat jest przestarzały i jego użycie jest ograniczone.Dla doświadczeń korzystających z obecnego TextChatService, odwołaj się do TextChannel:DisplaySystemMessage() .

<th>Typ</th>

    <th>Domyślny</th>

    <th>Opis</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td><code>tablica konfiguracji</code></td>

    <td>słownik</td>

    <td>(wymagane)</td>

    <td>Słownik informacji opisujący wiadomość (patrz poniżej).</td>
  </tr>
</tbody>

<th>Typ</th>

    <th>Domyślny</th>

    <th>Opis</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td><code>Tekst</code></td>

    <td>ciąg</td>

    <td>(wymagane)</td>

    <td>Wiadomość do wyświetlenia.</td>
  </tr>

  <tr>
    <td><code>Kolor</code></td>

    <td><code>Typ danych.Color3</code></td>

    <td><code>Typ danych.Color3.fromRGB(255, 255, 243)</code></td>

    <td>Kolor tekstu wiadomość.</td>
  </tr>

  <tr>
    <td><code>Czcionka</code></td>

    <td><code>Enumer.Font</code></td>

    <td><code>ŹródłoSansBold</code></td>

    <td>Czcionka wiadomość.</td>
  </tr>

  <tr>
    <td><code>Rozmiar tekstu</code></td>

    <td>liczba całkowita</td>

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

    <td>Rozmiar wiadomośćw wiadomości.</td>
  </tr>
</tbody>

Wyślij powiadomienie

Spowoduje pojawienie się nieinwazyjnej notyfikacji w prawym dolnym rogu ekranu. Notyfikacja może mieć do dwóch przycisków.

<th>Typ</th>

    <th>Domyślny</th>

    <th>Opis</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td><code>tablica konfiguracji</code></td>

    <td>słownik</td>

    <td>(wymagane)</td>

    <td>Słownik informacji opisujący powiadomienie (patrz poniżej).</td>
  </tr>
</tbody>

<th>Typ</th>

    <th>Domyślny</th>

    <th>Opis</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td><code>Tytuł</code></td>

    <td>ciąg</td>

    <td>(wymagane)</td>

    <td>Tytuł powiadomienie.</td>
  </tr>

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

    <td>ciąg</td>

    <td>(wymagane)</td>

    <td>Główny tekst powiadomienie.</td>
  </tr>

  <tr>
    <td><code>ikona</code></td><td>ciąg</td>

    <td />

    <td>Obraz do wyświetlenia z powiadomieniem.</td>
  </tr>

  <tr>
    <td><code>Długość</code></td>

    <td>number liczba</td>

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

    <td>Czas trwania (w sekundach) powiadomienie powinno pozostać widoczne.</td>
  </tr>

  <tr>
    <td><code>Powrót</code></td><td><code>Klasa.BindableFunction</code></td>

    <td />

    <td>Klasa <code>Class.BindableFunction</code>, która powinna być wywołana za pomocą tekstu przycisku naciśniętego przez gracza.</td>
  </tr>

  <tr>
    <td><code>Przycisk1</code></td><td>struny</td>

    <td />

    <td>Tekst do wyświetlenia na pierwszym przycisku.</td>
  </tr>

  <tr>
    <td><code>Przycisk2</code></td><td>struny</td>

    <td />

    <td>Tekst do wyświetlenia na drugim przycisku.</td>
  </tr>
</tbody>

Pasek górny włączony

Określa, czy pasek górny jest wyświetlany.Wyłączenie paska górnego również wyłączy wszystkie CoreGuis takie jak czat, wyposażeniei lista graczy (na przykład te ustawione za pomocą SetCoreGuiEnabled).

Gdy jest wyłączony, region, który kiedyś zajmował pasek, nadal będzie rejestrował zdarzenia myszy; jednak przyciski umieszczone tam nie będą reagować na kliknięcia.Pochodzenie przestrzeni GUI nadal będzie odległe o 36 pikseli od góry ekranu.

<th>Typ</th>

    <th>Domyślny</th>

    <th>Opis</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td><code>włączone</code></td>

    <td>booleanowy</td>

    <td>(wymagane)</td>

    <td>Określa, czy pasek górny powinien być widoczny.</td>
  </tr>
</tbody>

Widoczna konsola programisty

Określa, czy konsola Dewelopera jest widoczna.

<th>Typ</th>

    <th>Domyślny</th>

    <th>Opis</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td><code>widoczność</code></td>

    <td>booleanowy</td>

    <td>(wymagane)</td>

    <td>Określa, czy konsola jest widoczna.</td>
  </tr>
</tbody>

Szybka wysyłka prośby o przyjaciela

Wymaga od obecnego gracza wysłania prośby o przyjaciela do podanego Player.

<th>Typ</th>

    <th>Domyślny</th>

    <th>Opis</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td><code>gracz</code></td>

    <td><code>Klasa.Gracz</code></td>

    <td>(wymagane)</td>

    <td>Gracz, do którego należy wysłać prośbę o przyjacielazd.</td>
  </tr>
</tbody>

Ostrzeżenie o odłączeniu przyjaciół

Wymaga od obecnego gracza usunięcia określonego Player z listy przyjaciół.

<th>Typ</th>

    <th>Domyślny</th>

    <th>Opis</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td><code>gracz</code></td>

    <td><code>Klasa.Gracz</code></td>

    <td>(wymagane)</td>

    <td>Gracz, który powinien być odłączony od przyjaciół.</td>
  </tr>
</tbody>

Szybki blok player

Wymaga od obecnego gracza zablokowania podanego Player.

<th>Typ</th>

    <th>Domyślny</th>

    <th>Opis</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td><code>gracz</code></td>

    <td><code>Klasa.Gracz</code></td>

    <td>(wymagane)</td>

    <td>Gracz, który powinien być zablokowany.</td>
  </tr>
</tbody>

Odblokuj gracza Prompt

Wymaga od obecnego gracza odblokowania podanego Player.

<th>Typ</th>

    <th>Domyślny</th>

    <th>Opis</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td><code>gracz</code></td>

    <td><code>Klasa.Gracz</code></td>

    <td>(wymagane)</td>

    <td>Gracz, który powinien być odblokowany.</td>
  </tr>
</tbody>

Menu kontekstu awatara włączone

Określa, czy menu kontekstowe Avatar jest włączone.

<th>Typ</th>

    <th>Domyślny</th>

    <th>Opis</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td><code>włączone</code></td>

    <td>booleanowy</td>

    <td>(wymagane)</td>

    <td>Określa, czy menu kontekstowe jest włączone.</td>
  </tr>
</tbody>

Menu kontekstowe awataraTarget

Siłowo otwiera menu kontekstu awatara Avatar.

<th>Typ</th>

    <th>Domyślny</th>

    <th>Opis</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td><code>gracz</code></td>

    <td><code>Klasa.Gracz</code></td>

    <td>(wymagane)</td>

    <td>Gracz, na który zostanie otwarte menu kontekstowe.</td>
  </tr>
</tbody>

Dodaj opcję menu kontekstu awatara

Dodaje opcję do menu kontekstu awatara.

<th>Typ</th>

    <th>Domyślny</th>

    <th>Opis</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td><code>opcja</code></td>

    <td><code>Opcja menu kontekstu awatara Enum.AvatarContextMenuOption</code></td>

    <td>(wymagane)</td>

    <td>Opcja dodawać.</td>
  </tr>

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

  <tr>
    <td><code>opcja</code></td>

    <td>stół</td>

    <td>(wymagane)</td>

    <td>Tabela dwuelementowa, w której pierwszy jest nazwa niestandardowej akcji, a drugi to <code>Class.BindableEvent</code>, który zostanie uruchomiony z graczem, gdy opcja została aktywowana.</td>
  </tr>
</tbody>

Usuń opcję menu kontekstu awatara

Usuwa opcję do menu kontekstowego awatara. Argument option musi być taki sam, jak używany z "AddAvatarContextMenuOption" (patrz powyżej).

<th>Typ</th>

    <th>Domyślny</th>

    <th>Opis</th>
  </tr>
</thead>

<tbody>
  <tr>
    <td><code>opcja</code></td>

    <td>Opcja</td>

    <td>(wymagane)</td>

    <td>Ta sama wartość dostarczona do <b>Dodaj opcję menu kontekstu awatara</b>.</td>
  </tr>
</tbody>

Menu tematu kontekstu awatara

Konfiguruje dostosowywalne Menu kontekstowe awatara, które jest funkcją opcjonalną, która umożliwia łatwą interakcję gracza z graczem za pomocą niestandardowych działań, takich jak inicjowanie wymian, bitew i więcej.Aby uzyskać więcej informacji o tym, jak dostosować jego motyw, zobacz artykuł Menu kontekstowe awatara.

Połączenia CoreGuiChat

Ustawia połączenie przekaźnika wiązalnego między przyciskiem czatu w pasku górnym CoreGui a systemem czatu dziedzictwa.Drugi parametr musi być tabelą BindableEvents i BindableFunctions.

Parametry

Zwroty

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,
})

Funkcja ta ustawia, czy element CoreGui powiązany z danym Enum.CoreGuiType jest włączony lub wyłączony.

Pasek górny nie może być wyłączony za pomocą tej funkcji. Aby go wyłączyć, ustaw "TopbarEnabled" na false za pomocą StarterGui:SetCore().

Parametry

Zwroty

Ta metoda zwraca zestaw danych lub jest dostępna za pośrednictwem głównych skryptów Roblox.Pierwszy i jedyny parametr to ciąg znaków, który wybiera informacje do pobrania.Następujące sekcje opisują struny i dane, które zwracają przez tę funkcję.

Wezwanie tej metody może dać. Wiele z nich rejestruje również odpowiednią funkcję SetCore() (są oznaczone gwiazdką).

Powiadomienia o punktach aktywne *

Wyświetla true jeśli powiadomienia o punktach gracza są włączone.

OdznakiNotifikacjeAktywne *

Wyświetla true jeśli powiadomienia o odznakach są włączone.

Menu kontekstu awatara włączone *

Wyświetla true jeśli włączono menu kontekstowe awatara.

Aktywny czat *

Zwraca, czy czat jest aktywny, czy nie. Wskazuje to stan wyboru ikonaczatu w pasku górnym.

Rozmiar okna czatu *

Zwraca rozmiar okna czatu jako UDim2.

Pozycja okna czatu *

Zwraca rozmiar okna czatu jako UDim2.

Pasek czatu wyłączony *

Wyświetla true jeśli pasek czatu jest wyłączony.

Zdobądź ID użytkownika zablokowanego

Zwraca listę UserIds związanych z użytkownikami, które zostały zablokowane przez lokalnego gracza.

Wydarzenie zablokowane graczem

Zwraca BindableEvent, które jest uruchamiane za każdym razem, gdy gracz jest blokowany przez lokalnego gracza.

Wydarzenie odblokowane gracza

Zwraca BindableEvent, które jest uruchamiane za każdym razem, gdy gracz jest odblokowany przez lokalnego gracza.

Wyciszony graczEvent

Zwraca BindableEvent, które jest uruchamiane za każdym razem, gdy gracz jest wyciszany przez lokalnego gracza.

Wydarzenie PlayerUnmuted

Zwraca BindableEvent, które jest uruchamiane za każdym razem, gdy gracz jest wyciszany przez lokalnego gracza.

Wydarzenie PlayerFriended

Zwraca BindableEvent, które są uruchamiane za każdym razem, gdy gracz jest przyjmowany przez lokalnego gracza.

Wydarzenie GraczaUnfriended

Zwraca BindableEvent, które są uruchamiane za każdym razem, gdy gracz jest odłączony od lokalnego gracza.

Widoczna konsola rozwojowa *

Wyświetla true jeśli konsola dla programistów jest widoczna.

VRRotacjaIntensywność

Zwraca ciąg opisujący czułość rotacji kamery w VR: Low , High i Smooth.Nie będzie to dostępne, chyba że VRService.VREnabled jest true.

Parametry

Zwroty