StarterGui

Pozwala StarterGui przetwarzać wejścia jak PlayerGui i CoreGui do. Domyślną wartością jest 1> false1> .

Ten właściwość ustawia preferowany tryb orientacji ekranu dla użytkowników z urządzeń mobilnych. Dla różnych trybów dostępnych, see Enum.ScreenOrientation .

Domyślnie właściwość ustawiona na Sensor, co oznacza, że eksperyment jest wyświetlany w zależności od najlepszego dopasowania do orientacji urządzenie, czy to w kształcie krajobrazu (lewo/prawo) czy portretu.

Gdy Player dołącza do doświadczenia na urządzeniemobilnym, ta właściwość określa orientację urządzeniei ustawia orientację tego gracza PlayerGui.ScreenOrientation odpowiednio. Możesz również uzyskać orientację ekranu gracza poprzez Class.PlayerGui.CurrentScreen

Uwaga, że zmiana tego 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.

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

Funkcja ta weryfikuje, czy dany Enum.CoreGuiType jest włączony lub czy został wyłączony za pomocą StarterGui:SetCoreGuiEnabled(). Ta funkcja powinna być wzywana na klient.

Uwaga, że ustawienie "TopbarEnabled" do false przy użyciu SetCore() ukrywa wszystkie 1> enum.coreGuiType|coreGuiTypes1> ale nie wpływa na wynik tej funkcji.

Parametry

Zwroty

local StarterGui = game:GetService("StarterGui")

print(StarterGui:GetCoreGuiEnabled("PlayerList"))

Ten metod (nie myl się z SetCoreGuiEnabled() ) wyjaśnia różnorodną funkcjonalność zdefiniowaną przez rdzenie skryptów Roblox, taką jak wysyłanie powiadomień, włączanie powiadomień dla znaczków/punktów, określanie w zwijce dla przycisku resetowego lub włączanie wtyczki na pasku.

Pierwszy parametr to strona, która wybiera funkcjonalność, z którą wchodzi we wchodzenie we wchodzenie w interakcję. Może być konieczne, aby wejść w metodę pcall() w przypadku, gdy odpowiedni kod rdzenia nie został jeszcze załadowany (lub jeśli został całkowicie wyłączony).

Poniższy tabela opisuje zmienne, które można zaakceptować jako pierwszy parametr. Parametry, które należy podać, są zależne od funkcjonalności, która zostanie użyta i są opisane w podtablicach.

CzatAktywny

Kontroluje, czy czat jest aktywny.

<tbody>
  <tr>
    <td><code>aktywny</code></td>
    <td>boolean</td>
    <td>(wymagane)</td>
    <td>Określa, czy czat powinien być aktywny.</td>
  </tr>
</tbody>

Aktywne powiadomienia o punktach

Kontroluje czy pojawiają się powiadomienia o zdobytych punktach gracza.

<tbody>
  <tr>
    <td><code>aktywny</code></td>
    <td>boolean</td>
    <td>(wymagane)</td>
    <td>Określa, czy pojawią się powiadomienia o zdobytych punktach gracza.</td>
  </tr>
</tbody>

Notyfikaty

Kontroluje czy pojawiają się wiadomości o zdobytych odznakach.

<tbody>
  <tr>
    <td><code>aktywny</code></td>
    <td>boolean</td>
    <td>(wymagane)</td>
    <td>Określa, czy pojawią się powiadomienia o zdobytych odznakach.</td>
  </tr>
</tbody>

PrzyciskReset

Określa zachowanie, jeśli istnieje, przycisku zresetowania dany przez button lub BindableEvent do zresetowania, gdy gracz wniesie prośbę o resetować.

<tbody>
  <tr>
    <td><code>włączone</code></td>
    <td>boolean</td>
    <td>(wymagane)</td>
    <td>Określa, czy przycisk resetu zachowuje swoje domyślne zachowanie.</td>
  </tr>

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

  <tr>
    <td><code>callback)</code></td>
    <td><code>Klasa .BindableEvent</code></td>
    <td>(wymagane)</td>
    <td>Klasa <code>Class.BindableEvent</code> do zainicjowania, gdy gracz potwierdzi, że chce zresetować.</td>
  </tr>
</tbody>

Wiadomość systemu czatu

Pokaż ustrukturyzowaną wiadomość w czacie.

<tbody>
  <tr>
    <td><code>konfigTabela</code></td>
    <td>słownik</td>
    <td>(wymagane)</td>
    <td>Dizionarium informacji opisujące wiadomość (zobacz poniżej).</td>
  </tr>
</tbody>

<tbody>
  <tr>
    <td><code>Tekst</code></td>
    <td>ciąg</td>
    <td>(wymagane)</td>
    <td>Treść do wyświetlenia.</td>
  </tr>

  <tr>
    <td><code>Kolor</code></td>
    <td><code>Datatype.Color3</code></td>
    <td><code>Datatype.Color3.fromRGB(255, 255, 243)</code></td>
    <td>Kolor tekstu wiadomość.</td>
  </tr>

  <tr>
    <td><code>Font</code></td>
    <td><code>Fonty</code></td>
    <td><code>ŹródłoSansBold</code></td>
    <td>Font wiadomość.</td>
  </tr>

  <tr>
    <td><code>Rozmiar tekstu</code></td>
    <td>liczby</td>
    <td><code>18</code></td>
    <td>Rozmiar wiadomośćwiadomości.</td>
  </tr>
</tbody>

Wyślij powiadomienie

Powoduje, że pojawi się nieinwazyjna notyfikacja w dolnej prawnej części ekranu. Notyfikacja może mieć do dwóch przycisków.

<tbody>
  <tr>
    <td><code>konfigTabela</code></td>
    <td>słownik</td>
    <td>(wymagane)</td>
    <td>Dizionarium informacji opisujące powiadomienie (zobacz poniżej).</td>
  </tr>
</tbody>

<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>Czas trwania</code></td>
    <td>liczba</td>
    <td><code>5)</code></td>
    <td>Czas (w sekundach) wiadomość powinna pozostać widoczna.</td>
  </tr>

  <tr>
    <td><code>Callback)</code></td>
    <td><code>Klasa .BindableFunction</code></td>

    <td />

    <td>Klasa <code>Class.BindableFunction</code>, która powinna być wzywana z tekstem przycisku naciśniętego przez gracza.</td>
  </tr>

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

    <td />

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

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

    <td />

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

TopbarWłączony

Określa, czy top bar jest wyświetlany. Wyłączenie top bar będzie również wyłączać wszystkie CoreGuis takie jak czat, wyposażeniei lista graczy (na przykład, te ustawione z SetCoreGuiEnabled ) .

Gdy jest wyłączony, górna barwna okładka nadal będzie capturować wydarzenia myszy; jednak przyciski umieszczone tam nie będą reagować na kliknięcia. Główny pasek GUI będzie nadal odległy o 36 pikseli od góry ekranu.

<tbody>
  <tr>
    <td><code>włączone</code></td>
    <td>boolean</td>
    <td>(wymagane)</td>
    <td>Określa, czy w górnej barze powinno być widoczne.</td>
  </tr>
</tbody>

DevConsoleWidoczny

Określa czy Konsola Rozwiniętego Oprogramowania jest widoczna.

<tbody>
  <tr>
    <td><code>widoczność</code></td>
    <td>boolean</td>
    <td>(wymagane)</td>
    <td>Określa czy konsola jest widoczna.</td>
  </tr>
</tbody>

Wyślij prośbę o przyjaciela

Prosi bieżącego gracza o wysłanie prośby o przyjaciela do podanego Player .

<tbody>
  <tr>
    <td><code>gracz</code></td>
    <td><code>Klasa.Player</code></td>
    <td>(wymagane)</td>
    <td>Gracz, do którego należy wysłać prośbę o przyjacielazd.</td>
  </tr>
</tbody>

Zapytaj o przyjaciela

Prosi bieżącego gracza, aby usunął dany Player z jego listy przyjaciół.

<tbody>
  <tr>
    <td><code>gracz</code></td>
    <td><code>Klasa.Player</code></td>
    <td>(wymagane)</td>
    <td>Gracz, który powinien zostać usunięty z przyjaciół.</td>
  </tr>
</tbody>

GryczystyBlockPlayer

Prosi bieżącego gracza, aby zablokował Player .

<tbody>
  <tr>
    <td><code>gracz</code></td>
    <td><code>Klasa.Player</code></td>
    <td>(wymagane)</td>
    <td>Gracz, który powinien być zablokowany.</td>
  </tr>
</tbody>

Zwróć pytanie

Prosi bieżącego gracza o odblokowanie danej Player .

<tbody>
  <tr>
    <td><code>gracz</code></td>
    <td><code>Klasa.Player</code></td>
    <td>(wymagane)</td>
    <td>Gracz, który powinien zostać odblokowany.</td>
  </tr>
</tbody>

AwatarKontekstMenuWłączone

Określa, czy Awatarowy Menu Kontekstowe jest włączony.

<tbody>
  <tr>
    <td><code>włączone</code></td>
    <td>boolean</td>
    <td>(wymagane)</td>
    <td>Określa, czy menu kontekstowe jest włączone.</td>
  </tr>
</tbody>

AwatarKontekstMenu

Siłą otwiera Menu Kontekstu Avatara.

<tbody>
  <tr>
    <td><code>gracz</code></td>
    <td><code>Klasa.Player</code></td>
    <td>(wymagane)</td>
    <td>Gracz, na którym otworzone zostanie menu kontekstowe.</td>
  </tr>
</tbody>

Dodaj menu kontekstu awatara

Dodaje opcję do Menu Kontekstowego Avatara .

<tbody>
  <tr>
    <td><code>opcja</code></td>
    <td><code>Menu.NawarstwienieAwatarium</code></td>
    <td>(wymagane)</td>
    <td>Opcja do dodawać.</td>
  </tr>

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

  <tr>
    <td><code>opcja</code></td>
    <td>tabela</td>
    <td>(wymagane)</td>
    <td>Tabela dwuelementowa, w której pierwszy jest nazwą dostosowanej akcji, a drugi jest <code>Class.BindableEvent</code>, który zostanie uruchomiony z wybranym graczem, gdy opcja została aktywowana.</td>
  </tr>
</tbody>

Usuń menu kontekstu awatara

Usuwa opcję z menu Kontekst Avatar. Artykuł option musi być taki sam jak ten, który był używany z "AddAvatarContextMenuOption" (patrz powyżej).

<tbody>
  <tr>
    <td><code>opcja</code></td>
    <td>Wariant</td>
    <td>(wymagane)</td>
    <td>Ta sama wartość zaoferowana <b>Dodaj menu kontekstu awatara</b>.</td>
  </tr>
</tbody>

Menu motywów awatarów

Konfiguruje dostosowywalny Avatar Context Menu , który jest opcjonalną funkcją, która umożliwia łatwą interakcję gracza na gracza poprzez niestandardowe działania, takie jak inicjowanie wymian, bitw i innych. Dla więcej informacji na temat sposobu dostosowania jego motywu, zobacz artykuł Avatar Context Menu.

Połączenia z GUI

Ustawia powiązaną z gatunkiem połączenie między przyciskiem czatu CoreGui i systemem czatu w przeszłości. Połącznikiem drugim musi być tabela 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 podanym Enum.CoreGuiType jest włączony lub wyłączony.

Nie można wyłączyć górnej listy za pomocą tej funkcji. Aby to wyłączyć, ustaw "TopbarEnabled" do false przy użyciu StarterGui:SetCore() .

Parametry

Zwroty

Ten metod returnuje zestaw danych lub udostępnionych przez rdzenie skryptów Roblox. Pierwszy i jedyny parametr to łańcuch, który wybiera informacje do odczytania. Następne sekcje opisują łańcuchy i dane, które są zwracane przez tę funkcję.

Wywołanie metody może zwrócić. Wiele z tych również rejestruje równivalentną funkcję SetCore() (te są oznaczone gwiazdką).

Notyfikacja punktów *

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

Notyfikaty aktywne *

Wyświetla powiadomienia odznaczeń, jeśli powiadomienia odznaczeń są włączone.

AvatarContextMenuWłączone *

Wróci true, jeśli Menu Kontekstu Avatara jest włączone.

CzatAktywny *

Wyjaśnia, czy czat jest aktywny czy nie. To jest wskazane przez stan wyboru ikonaczatu na górnej barze.

Rozmiar okienka czatu *

Zwraca rozmiar okna czatu jako UDim2 .

Pozycja okna czatu *

Zwraca rozmiar okna czatu jako UDim2 .

ChatBarDisabled *

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

Zdobądź zablokowane identyfikatory użytkowników

Wyświetla listę UserIds związanych z użytkownikami, którzy zostali zablokowani przez lokalnego gracza.

Zablokowane gracze

Zwraca BindableEvent, który jest uruchamiany za każdym razem, gdy gracz jest zablokowany przez lokalnego gracza.

Zablokowane zdarzenie gracza

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

Zgłoszony gracz

Zwraca BindableEvent, który jest uruchamiany za każdym razem, gdy gracz jest zmutowany przez lokalnego gracza.

Zresetowany gracz

Zwraca BindableEvent, który jest uruchamiany za każdym razem, gdy gracz zostanie odgłoszone przez lokalnego gracza.

Zwrot gracza

Zwraca BindableEvent, który jest uruchamiany za każdym razem, gdy gracz jest przyjacielem lokalnego gracza.

NieprzyjacielskiEvent

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

DevConsoleVisible *

Wyświetla true, jeśli Konsola Rozwój jest widoczna.

VRRotacjaIntensity

Zwraca strungę opisującą czułość obrotu kamery w VR: Low, High i Smooth. Nie będzie ona dostępna, chyba że 1> Class.VRService.VREnabled1> jest 4> true4> .

Parametry

Zwroty