StarterGui

Consente a StarterGui di elaborare l'input come PlayerGui e CoreGui fanno. Il valore predefinito è 1> false1> .

Questa proprietà imposta la modalità di orientamento della schermata preferita per gli utenti con dispositivi mobili. Per i diversi modelli disponibili, vedi Enum.ScreenOrientation .

Per impostazione predefinita, questa proprietà è impostata su Sensor , il che significa che l'esperienza viene visualizzata a seconda della migliore corrispondenza all'orientamento attuale del Dispositivo, sia in termini di larghezza (sinistra/destra) che in termini di portrait.

Quando un Player si unisce all'esperienza su un Dispositivomobile, questa proprietà determina l'orientamento di partenza del Dispositivoe imposta l'orientamento di quel Giocatorein conseguenza. Puoi anche ottenere l'orientamento della schermata attuale del Giocatoreattraverso PlayerGui.ScreenOrientation, utile quando si utilizzano una delle impostazioni

Nota che la modifica di questa proprietà non cambierà l'orientamento dello schermo per Players già nell'esperienza. Per cambiare l'orientamento per un Giocatoreesistente, usa la loro ProprietàPlayerGui.ScreenOrientation .

Questa proprietà determina se i contenuti di StarterGui sono visibili in Studio.

Questa funzione restituisce se è abilitato il Enum.CoreGuiType o se è stato disabilitato utilizzando StarterGui:SetCoreGuiEnabled() . Questa funzione dovrebbe essere chiamata sul client.

Nota che impostando "TopbarEnabled" su false utilizzando SetCore() nascosta tutto 1> Class.CoreGuiType|Class.GuiTypes1> ma non influisce sul risultato di questa funzione.

Parametri

Restituzioni

local StarterGui = game:GetService("StarterGui")

print(StarterGui:GetCoreGuiEnabled("PlayerList"))

Questo metodo (non essere confuso con SetCoreGuiEnabled() ) espose una varietà di funzionalità definite dagli script del core di Roblox, come l'invio di notifiche, l'attivazione delle notifiche per badge/punti, l'定義 di un callback per il pulsante di ripristino o l'attivazione della barra superiore.

Il primo parametro è una stringa che seleziona la funzionalità con cui l'appuntamento interagirà. Potrebbe essere necessario chiamare questo metodo più volte usando pcall() in caso che lo script del nucleo rispetti ancora non abbia caricato (o se è stato disabilitato completamente).

La seguente tabella descrive le string che possono essere accettate come primo parametro. I parametri che seguono sono dipendenti dalla funzionalità che verrà utilizzata e sono descritti in sottotabelle.

ChatAttivo

Controlla se la chat è attiva.

<tbody>
  <tr>
    <td><code>attivo</code></td>
    <td>booleano</td>
    <td>(richiesto)</td>
    <td>Determina se la chat deve essere attivata.</td>
  </tr>
</tbody>

Notifiche punti attive

Controlla se le notifiche per i punti giocatore guadagnati appariranno.

<tbody>
  <tr>
    <td><code>attivo</code></td>
    <td>booleano</td>
    <td>(richiesto)</td>
    <td>Determina se le notifiche per i punti giocatore guadagnati appariranno.</td>
  </tr>
</tbody>

BadgeNotificheAttive

Controlla se le notifiche per i badge guadagnati appariranno.

<tbody>
  <tr>
    <td><code>attivo</code></td>
    <td>booleano</td>
    <td>(richiesto)</td>
    <td>Determina se le notifiche per i badge guadagnati appariranno.</td>
  </tr>
</tbody>

ResetButtonCallback

Determina il comportamento, se presente, del pulsante di ripristino dato a unoBoolean o a un BindableEvent da attivare quando un giocatore richiede di Ripristina.

<tbody>
  <tr>
    <td><code>abilitato</code></td>
    <td>booleano</td>
    <td>(richiesto)</td>
    <td>Determina se il pulsante di ripristino mantiene il suo comportamento predefinito.</td>
  </tr>

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

  <tr>
    <td><code>callback</code></td>
    <td><code>Class.BindableEvent</code></td>
    <td>(richiesto)</td>
    <td>Un <code>Class.BindableEvent</code> per essere attivato quando il giocatore conferma di voler Ripristina.</td>
  </tr>
</tbody>

ChatMakeSystemMessage

Mostra un messaggio formattato nella chat.

<tbody>
  <tr>
    <td><code>tabella di configurazione</code></td>
    <td>dizionario</td>
    <td>(richiesto)</td>
    <td>Un dizionario di informazioni che descrive il messaggio (vedi sotto).</td>
  </tr>
</tbody>

<tbody>
  <tr>
    <td><code>Testo</code></td>
    <td>stringa</td>
    <td>(richiesto)</td>
    <td>Il messaggio da visualizzare.</td>
  </tr>

  <tr>
    <td><code>Colore</code></td>
    <td><code>Datatype.Color3</code></td>
    <td><code>Datatype.Color3.fromRGB(255, 255, 243)</code></td>
    <td>Colore del testo del Messaggio.</td>
  </tr>

  <tr>
    <td><code>Carattere</code></td>
    <td><code>Font di Enumerazione</code></td>
    <td><code>SourceSansBold</code></td>
    <td>Font del Messaggio.</td>
  </tr>

  <tr>
    <td><code>TextSize</code></td>
    <td>integro</td>
    <td><code>18</code></td>
    <td>Dimensione del testo del Messaggio.</td>
  </tr>
</tbody>

Invia notifica

Causa una notifica non invasiva a apparire in basso a destra dello schermo. La notifica può avere fino a due pulsanti.

<tbody>
  <tr>
    <td><code>tabella di configurazione</code></td>
    <td>dizionario</td>
    <td>(richiesto)</td>
    <td>Un dizionario di informazioni che descrive la notifica (vedi sotto).</td>
  </tr>
</tbody>

<tbody>
  <tr>
    <td><code>Titolo</code></td>
    <td>stringa</td>
    <td>(richiesto)</td>
    <td>Il titolo della Notifiche.</td>
  </tr>

  <tr>
    <td><code>Testo</code></td>
    <td>stringa</td>
    <td>(richiesto)</td>
    <td>Il testo principale della Notifiche.</td>
  </tr>

  <tr>
    <td><code>Icona</code></td>
    <td>stringa</td>

    <td />

    <td>L'immagine da visualizzare con la Notifiche.</td>
  </tr>

  <tr>
    <td><code>Durata</code></td>
    <td>number</td>
    <td><code>5</code></td>
    <td>Durata (in secondi) la notifica dovrebbe rimanere visibile.</td>
  </tr>

  <tr>
    <td><code>Callback</code></td>
    <td><code>Class.BindableFunction</code></td>

    <td />

    <td>Un <code>Class.BindableFunction</code> che dovrebbe essere invocato con il testo del pulsante premuto dal Giocatore.</td>
  </tr>

  <tr>
    <td><code>Button1 ]</code></td>
    <td>stringa</td>

    <td />

    <td>Il testo da mostrare sul primo pulsante.</td>
  </tr>

  <tr>
    <td><code>Button2 ]</code></td>
    <td>stringa</td>

    <td />

    <td>Il testo da mostrare sul secondo pulsante.</td>
  </tr>
</tbody>

TopbarAbilitato

Determina se la barra superiore viene visualizzata. Disabilitare la barra superiore disabiliterà anche tutte le CoreGuis come la chat, l'Inventario, reportorioe la lista dei giocatori (per esempio, quelle impostate con SetCoreGuiEnabled ).

Quando è disabilitato, la regione della barra superiore una volta occupata continuerà ad aggiungere eventi al mouse; tuttavia, i pulsanti posizionati lì non risponderanno ai clic. L'origine dello spazio GUI sarà ancora offsetta di 36 pixel dalla parte superiore dello schermo.

<tbody>
  <tr>
    <td><code>abilitato</code></td>
    <td>booleano</td>
    <td>(richiesto)</td>
    <td>Determina se la barra superiore deve essere visibile.</td>
  </tr>
</tbody>

DevConsoleVisibile

Determina se la Console dello Sviluppatore è visibile.

<tbody>
  <tr>
    <td><code>visibilità</code></td>
    <td>booleano</td>
    <td>(richiesto)</td>
    <td>Determina se la console è visibile.</td>
  </tr>
</tbody>

Invia richiesta di amico

Invita il giocatore corrente a inviare una richiesta di amico al Player .

<tbody>
  <tr>
    <td><code>giocatore</code></td>
    <td><code>Class.Player</code></td>
    <td>(richiesto)</td>
    <td>Il giocatore a cui richiesta amico Sentenza</td>
  </tr>
</tbody>

PromptUnfriend

Richiede al giocatore corrente di rimuovere un dato Player dalla loro lista amici.

<tbody>
  <tr>
    <td><code>giocatore</code></td>
    <td><code>Class.Player</code></td>
    <td>(richiesto)</td>
    <td>Il giocatore che dovrebbe essere un amico.</td>
  </tr>
</tbody>

Giocatore di blocchi

Richiede al giocatore attuale di bloccare il Player .

<tbody>
  <tr>
    <td><code>giocatore</code></td>
    <td><code>Class.Player</code></td>
    <td>(richiesto)</td>
    <td>Il giocatore che dovrebbe essere bloccato.</td>
  </tr>
</tbody>

PromptUnblockPlayer

Richiede al giocatore corrente di sbloccare il Player .

<tbody>
  <tr>
    <td><code>giocatore</code></td>
    <td><code>Class.Player</code></td>
    <td>(richiesto)</td>
    <td>Il giocatore che dovrebbe essere sbloccato.</td>
  </tr>
</tbody>

AvatarContextMenuAbilitato

Determina se il Avatar Context Menu è abilitato.

<tbody>
  <tr>
    <td><code>abilitato</code></td>
    <td>booleano</td>
    <td>(richiesto)</td>
    <td>Determina se il menu contestuale è abilitato.</td>
  </tr>
</tbody>

AvatarContextMenuTarget

Forza apre il Avatar Context Menu .

<tbody>
  <tr>
    <td><code>giocatore</code></td>
    <td><code>Class.Player</code></td>
    <td>(richiesto)</td>
    <td>Il giocatore su cui verrà aperto il menu contestuale.</td>
  </tr>
</tbody>

Aggiungi opzione menu contestuale avatar

Aggiunge un'opzione al Avatar Context Menu .

<tbody>
  <tr>
    <td><code>opzione</code></td>
    <td><code>Enum.AvatarContextMenuOption</code></td>
    <td>(richiesto)</td>
    <td>Opzione di aggiungere or Inserire.</td>
  </tr>

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

  <tr>
    <td><code>opzione</code></td>
    <td>tabella</td>
    <td>(richiesto)</td>
    <td>Una tabella a due elementi, in cui il primo è il nome dell'azione personalizzata e il secondo è un <code>Class.BindableEvent</code> che verrà attivato con un giocatore selezionato quando l'opzione è stata attivata.</td>
  </tr>
</tbody>

RimuoviAvatarContextMenuOption

Rimuove un'opzione dal Avatar Context Menu . L'argomento option deve essere lo stesso di quello usato con "AddAvatarContextMenuOption" (vedi sopra).

<tbody>
  <tr>
    <td><code>opzione</code></td>
    <td>Variante</td>
    <td>(richiesto)</td>
    <td>Lo stesso valore fornito a <b>AddAvatarContextMenuOption</b> .</td>
  </tr>
</tbody>

AvatarContextMenuTema

Configura il Avatar Context Menu che è un'opzione in abbonamento che consente una facile interazione tra giocatori via azioni personalizzate, come l'avvio di scambi, battaglie e altro ancora. Per ulteriori informazioni su come personalizzare il suo tema, vedi l'articolo Avatar Context Menu.

Connessioni CoreGuiChat

Imposta una connessione Gateway legata tra il pulsante di chat della barra superiore CoreGui e il sistema di chat legacy. Il secondo parametro deve essere una tabella di BindableEvents e BindableFunctions .

Parametri

Restituzioni

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

Questa funzione imposta se l'elemento CoreGui associato all'elemento Enum.CoreGuiType è abilitato o disabilitato.

La barra superiore non può essere disabilitata utilizzando questa funzione. Per disabilitarlo, imposta "TopbarEnabled" su false utilizzando StarterGui:SetCore() .

Parametri

Restituzioni

Questo metodo restituisce il valore impostato o reso disponibile dagli script del core di Roblox. Il primo e unico parametro è una stringa che seleziona le informazioni da recuperare. Le seguenti sezioni descrivono le stringhe e i dati che restituisce da questa funzione.

Chiamando questo metodo potrebbe essere generato. Molti di questi registra anche una funzione equivalente SetCore() (queste sono contrassegnate con un asterisco).

Notifiche punti attive *

Restituisce true se le notifiche punti giocatore sono abilitate.

BadgeNotificationsActive *

Restituisce true se le notifiche di badge sono abilitate.

AvatarContextMenuAbilitato *

Restituisce true se il Avatar Context Menu è abilitato.

ChatActive *

Restituisce se la chat è attiva o no. Questo è mostrato dallo stato di selezione dell'Iconadella chat nella barra superiore.

Dimensione di finestra di chat *

Restituisce la dimensione della finestra di chat come un UDim2 .

ChatWindowPosition *

Restituisce la dimensione della finestra di chat come un UDim2 .

ChatBarDisabled *

Restituisce true se la barra di chat è disabilitata.

OttieniBlockedUserIds

Restituisce una lista di UserIds associati agli utenti che sono stati bloccati dal Giocatorelocale.

PlayerBlockedEvent

Restituisce un BindableEvent che viene attivato ogni volta che un giocatore è bloccato dal Giocatorelocale.

PlayerUnblockedEvento

Restituisce un BindableEvent che viene attivato ogni volta che un giocatore viene sbloccato dal Giocatorelocale.

PlayerMutedEvento

Restituisce un BindableEvent che viene attivato ogni volta che un giocatore è disattivato dal Giocatorelocale.

PlayerUnmutedEvent

Restituisce un BindableEvent che viene attivato ogni volta che un giocatore viene disattivato dal Giocatorelocale.

Evento amico giocatore

Restituisce un BindableEvent che viene attivato ogni volta che un giocatore è amico del Giocatorelocale.

PlayerUnfriendedEvent

Restituisce un BindableEvent che viene attivato ogni volta che un giocatore viene disamichevato dal Giocatorelocale.

DevConsoleVisible *

Restituisce true se la Developer Console è visibile.

Velocità di rotazione

Restituisce una stringa che descrive la sensibilità della rotazione della fotocamera in VR: Low , High e Smooth . Questo non sarà disponibile a meno che 1> Class.VRService.VREnabled1> non sia 4> true4> .

Parametri

Restituzioni