User presence Type ['Offline' = 0, 'Online' = 1, 'InGame' = 2, 'InStudio' = 3, 'Invisible' = 4]

Presence Api v1

userPresenceRequest

Panoramica

Esperienze

Avatar

Risorse

Open Cloud

Creazione

Scoperta

Localizzazione

Analisi

Design

Scale

Affiliati

Monetize

Questo metodo è asincrono e restituisce un'"operazione", che rappresenta lo stato corrente della stessa. Contiene un percorso endpoint che è possibile sondare per ottenere la risposta reale e i metadati applicabili. Per ulteriori informazioni, consulta la [documentazione]({longRunningOperationsLink}) sulle operazioni di lunga durata.
            
Le sezioni seguenti descrivono gli oggetti di risposta e metadati forniti al completamento di un'operazione.

Gli endpoint beta sono pronti per l'uso del pubblico. Modifiche incompatibili sono possibili ma rare.

Questo campo può essere impostato durante la creazione di una risorsa, ma non può essere modificato da richieste successive.

È possibile impostare questi campi durante la creazione di una risorsa, ma non modificarli in base a richieste successive.

Questo campo può essere fornito per le richieste, ma non verrà mai incluso nelle risposte.

Per chiave API: {maxInPeriod} richieste ogni {periodInSeconds} secondi per indirizzo IP

Questo campo può essere impostato per le risposte, ma verrà ignorato nelle richieste.

Le seguenti autorizzazioni chiave API sono necessarie per chiamare questo endpoint. Per ulteriori informazioni sulla generazione di chiavi appropriate, vedi [Gestisci chiavi API]({apiKeyReferenceDocLink}).

I seguenti endpoint sono disponibili nei percorsi relativi all'URL di base.

Questa stringa è formattata come [Timestamp](/cloud/reference/types#timestamp).

Un valore JSON può essere `null`, `boolean`, `string`, `number`, `array`, or `object`.

I seguenti ambiti sono necessari per l'applicazione OAuth 2.0 per utilizzare questo endpoint. Per ulteriori informazioni su come registrare un'applicazione OAuth 2.0, vedi [Registrazione e revisione dell'app]({oauth2ReferenceDocLink}).

Gli oggetti seguenti descrivono i payloads accettati o restituiti. Per maggiori informazioni su quando vengono utilizzati questi oggetti, consultare ogni singolo endpoint.

Per utilizzare questo endpoint sono necessari i seguenti ambiti per la tua applicazione OAuth 2.0. Per ulteriori informazioni su come registrare un'applicazione OAuth 2.0, vedere [Registrazione e revisione dell'app]({oauth2ReferenceDocLink}).

Questo permette di visualizzare informazioni sui tuoi beni.

Questo permette di caricare e aggiornare gli asset su Roblox.

Fornisce la possibilità di aggiornare i badge di proprietà dell'utente.

Consente di visualizzare informazioni sui tuoi articoli commerciali.

Consente la modifica delle tue connessioni commerciali.

Consente di visualizzare le informazioni sui tuoi prodotti del Creator Store.

Consente di modificare le informazioni sui tuoi prodotti del Creator Store.

Consente di vedere le informazioni sulle tue comunità.

Consente di gestire le richieste di adesione alla comunità e gli aggiornamenti dei ruoli dei membri della comunità di rango inferiore per il tuo account.

Offre l'accesso per gestire i tuoi badge.

Consente l'accesso per gestire i tuoi badge e spendere Robux.

Consente l'accesso per gestire i tuoi prodotti per sviluppatori.

Consente l'accesso per leggere le informazioni sulle esperienze che segui.

Consente l'accesso per seguire e non seguire le esperienze per tuo conto.

Consente l'accesso per gestire le tue comunità.

Fornisce il permesso di leggere le informazioni sulla comunità.

Concede le autorizzazioni di gestione della comunità.

Consente l'accesso per leggere e scrivere le tue tabelle di localizzazione

Consente l'accesso per gestire la collaborazione in team per tutte le tue esperienze.

Consente l'accesso per gestire le tue esperienze e determinate informazioni associate alle tue esperienze (ad esempio, informazioni sulla localizzazione).

Offre l'accesso per leggere le informazioni sulla localizzazione delle tue esperienze.

Consente l'accesso per modificare le preferenze di localizzazione delle tue esperienze.

Consente l'accesso per gestire il tuo account utente.

Consente l'accesso per modificare le preferenze di localizzazione dell'utente.

Ciò garantisce la possibilità di pubblicare messaggi per conto degli utenti.

Consente di inviare notifiche dalla tua esperienza agli utenti.

Questo permette di elencare i segreti associati alla tua esperienza.

Ciò consente di creare e aggiornare i segreti associati alla tua esperienza.

Consente l'accesso per leggere i tuoi prodotti in abbonamento.

Offre la possibilità di leggere le informazioni sul posto.

Offre la possibilità di modificare le informazioni sul posto.

Questa operazione consente di pubblicare nuove versioni di esperienze a Roblox.

Offre la possibilità di leggere le informazioni sull'esperienza.

Offre la possibilità di modificare le informazioni sull'esperienza.

Consente di visualizzare le restrizioni degli utenti nell'esperienza.

Offre la possibilità di leggere lo stato premium e verificato dell'utente.

Consente di visualizzare gli account social di un utente.

Questa operazione abilita la funzionalità Single Sign-On.

Consente l'accesso alla lettura delle informazioni del tuo profilo.

Valore predefinito: {defaultValueStart}{defaultValueEnd}

Un vettore è un elenco ordinato di valori. I vettori sono utili per memorizzare le raccolte di dati.

Un insieme di coppie chiave-valore, in cui le chiavi possono essere qualsiasi numero, stringa o oggetto.

Questa funzione restituisce immediatamente, se possibile, ma può restituire il thread che lo ha chiamato fino a quando non può restituire un valore.

{nameStart}nome{nameEnd} non è più supportato o mantenuto da Roblox.

Questa operazione matematica non è più supportata o mantenuta da Roblox.

Questo membro non appare nel browser degli oggetti e non è destinato ad un uso diffuso.

Questo membro è accessibile solo tramite la barra dei comandi. Il tentativo di accedere a questo membro dagli script provoca un errore.

Questa funzione non può mettere in pausa il thread di Lua che l'ha chiamato.

Il tentativo di accedere a questo membro negli script causa un errore. Potresti essere in grado di accedere a questo membro dalla finestra delle proprietà di Roblox Studio.

Questo membro non appare nel browser degli oggetti di Roblox Studio.

Non è possibile creare un'istanza di questa classe con il Instance.new constructor.

Roblox non replica questo membro attraverso il suo confine server-client.

Il codice Lua non può accedere a questo membro. Potresti cambiare il suo valore dalla finestra di proprietà in Roblox Studio.

Questo membro è accessibile dalle attività di esecuzione di OpenCloud Luau.

Il comportamento di replica di questo oggetto dipende dal giocatore che lo possiede.

Questo membro è accessibile tramite la barra dei comandi e i plugin. Ogni tentativo di accesso a questo membro dagli script genererà un errore.

Questo membro è in sola lettura. Ogni tentativo di sovrascrittura genererà un errore.

Questa proprietà è in sola lettura ed è sicura da leggere in thread non sincronizzati. Ogni tentativo di sovrascrittura genererà un errore.

Questa proprietà è in sola lettura ed è sicura da leggere in thread non sincronizzati. Tentando di scriverci causa un errore.

Questo membro è accessibile solo in CoreScripts.

Solo Roblox CoreScripts può accedere a questo membro e non è utilizzabile dai giocatori.

È possibile leggere e scrivere a questa proprietà in modo sicuro da più thread.

Questa classe è un singleton di primo livello. Recupera un'istanza di questa classe con la funzione GetService.

Più thread possono potenzialmente scrivere su questa proprietà, quindi non è sicuro leggere da thread non sincronizzati.

È possibile leggere e sovrascrivere questa proprietà in modo sicuro da più thread.

Questa funzione interrompe il thread di Lua che lo chiamava fino a quando non restituisce un risultato. Questo non interrompe altri script.

Gestisci e analizza tutte le tue esperienze in un unico posto.

Impara con la documentazione e le risorse rivolte a tutti i creatori.

Scopri come creare esperienze Roblox grazie a guide, tutorial e campioni di codice.

Crea le tue esperienze in Studio, il nostro IDE all-in-one, e scaricalo su un'ampia varietà di dispositivi.

Dei modi affidabili per offrire valore nel tempo al tuo pubblico

Scopri come creare degli annunci efficaci che indirizzino il traffico verso le tue creazioni

Monitora la crescita della tua esperienza e scopri delle opportunità per migliorare

Scopri come applicare il movimento ai tuoi personaggi e ai tuoi ambienti

Scopri come caricare o utilizzare le risorse del Negozio nelle tue creazioni

Crea articoli Avatar e pubblicali sul Marketplace

Ordinato in base alle entrate più alte negli ultimi 7 giorni

Scopri cosa puoi realizzare e vendere sul marketplace

L'avatar rappresenta ciascun utente Roblox come un personaggio personalizzabile

Vedi questo flusso di creazioni fresche costruite dalla comunità

Impara le tecniche di modellazione di base in Blender

Troverai modelli, script e plugin sviluppati da altri creatori

Scopri come mettere in gabbia i tuoi articoli dell'avatar con l'artista 3D di Roblox

Scopri come configurare i personaggi per assicurarti che tutte le caratteristiche dell'avatar funzionino correttamente

Scopri come creare degli oggetti che interagiscono con il mondo o con altri utenti

Realizza e vendi il tuo primo capo di abbigliamento di base su Roblox

Usa gli strumenti di collaborazione di Studio per lavorare in contemporanea con il tuo team

Scopri qual è la tendenza sul Creatore Marketplace

Scopri i trend del momento sul Negozio Creatore

Partecipa agli eventi della comunità tenuti da altri Creatori

Trova tutorial scritti dalla Comunità Creatori

Mantieni i giocatori coinvolti e monetizza i contenuti con gli aggiornamenti

Affascina il pubblico con un divertente ciclo di gioco

Promuovi il coinvolgimento e i progressi con un gameplay divertente e ripetitivo

Scopri come creare una porta scorrevole senza scrivere alcun codice

Alex racconta la sua esperienza diretta con la creazione del gioco di successo, Jailbreak

Blake ha scoperto una passione nel creare giochi di carnevale realistici e stravaganti

I Clemens sono lo studio a conduzione familiare che ha realizzato successi come The Survival Game

Jasmine è l'artista che ha creato alcuni degli articoli per avatar più popolari sul Marketplace

Jessica è la designer di ambienti fantasiosi come in Alo Yoga

Jenni è la creatrice e artista di UGC che ha dato vita a molte collaborazioni popolari

Lo stile unico di Morphist combina estetica adorabile ed emo

I creatori di Riotfall viaggiano per trovare ispirazione per i loro ambienti coinvolgenti

Stephen condivide il suo amore per gli strumenti di programmazione

Sam racconta come ha iniziato a progettare degli articoli di moda che aveva sempre desiderato

Tutti gli oggetti che compongono un mondo 3D, come parti e illuminazione

Scopri la gamma di strumenti di debug disponibili in Studio

Guarda i tuoi progressi verso il tuo prossimo incasso!

Usa la console di sviluppo per eseguire il debug della tua esperienza durante i test

Aggiungere degli abbonamenti alla tua esperienza ti aiuterà a costruire relazioni a lungo termine con la tua base di utenti. Abilita gli abbonamenti entro il 15 dicembre 2023 e approfitta di 3 mesi di tariffe agevolate.

Guarda le migliori Esperienze per ottenere ispirazione

Inizia con Studio, il motore di creazione di Roblox

Aggiungi alcune righe di codice per sbloccare nuove dashboard che ti aiuteranno a comprendere il tuo onboarding e altri contenuti funnel, nonché a monitorare la tua economia di gioco.

Minty insegna a Enyu la geometria solida costruttiva.

Costruisci eventi live, cross-server e taglia scene su una sequenza strutturata

Scopri come creare eventi a tempo per le tue esperienze

Crea eventi basati sul tempo per una maggiore scoperta su Roblox. annuncia il tuo ultimo aggiornamento, evidenzia un'attività o festeggia un traguardo con i tuoi giocatori!

Scopri come indirizzare la fascia di età giusta per la tua creazione attraverso linee guida esperienza

Acquisisci conoscenze e competenze direttamente da Roblox

Scopri come implementare un sistema di ricompense per gli inviti agli amici

Impara le nozioni fondamentali su come creare un gioco

Scopri come puoi controllare il modo in cui i tuoi dati vengono utilizzati per addestrare l'IA. {linkStart}Leggi di più{linkEnd}

Crea facilmente delle strutture personalizzate utilizzando i nostri strumenti di intelligenza artificiale

Usa il nostro motore di creazione completo per costruire tutto ciò che puoi immaginare

PolarCub condivide tutti i trucchi per creare degli articoli UGC

Approfitta di Guilded per costruire una comunità attorno alla tua creazione

Unisciti al nostro incredibile cast di creatori per una maratona di sviluppo giochi di Halloween

Usa la parte della testa per creare delle animazioni facciali o attivare degli emote

Utilizza le metriche per capire dove puoi migliorare il tuo gameplay

Scopri come invogliare gli utenti a giocare di nuovo col tuo gioco

L'input dell'utente consente agli utenti di interagire con l'ambiente della tua esperienza

Guidano i giocatori attraverso la loro prima esperienza di gioco

Crea dei capi di abbigliamento che si adattano al corpo di qualsiasi avatar

A Roblox, crediamo che impari meglio facendo. Scegli una delle nostre guide per esplorare più di ciò che offre la piattaforma.

Ricevi aiuto per scrivere il codice e ottieni le risposte alle tue domande sul processo di creazione

Lighting e SoundService ti consentono di controllare gli effetti ambientali

Scopri come adattare i tuoi contenuti a diverse lingue e norme culturali

Questa guida passo-passo illustra allegati, fasci di luce e alcuni concetti di scripting di base che ti mostreranno come impostare la salute del giocatore su 0 se tocca qualcosa

Scopri come sperimentare rapidamente nuove idee

Coltivare una base di giocatori attivi è una parte fondamentale dello sviluppo di un gioco di successo e duraturo.

Inizia con lo strumento di ottimizzazione delle prestazioni e risoluzione dei problemi

MicroProfiler fornisce informazioni sui tempi per i processi dell'Agenda

Scopri nel dettaglio come funzionano i colori delle cornici, i grafici delle fiamme e altro ancora

Impara a utilizzare le metriche per avere più successo

Migliora le prestazioni degli script Luau ad alta intensità computazionale

Visualizza i tuoi benchmark giornalieri, i dati analitici e le metriche in tempo reale per portare {boldStart}{experienceName}{boldEnd} al livello successivo.

Scopri come utilizzare gli NPC (personaggi non giocanti) nelle tue esperienze

@minty crea dal vivo un percorso a ostacoli partendo da zero con i suggerimenti della chat

La nostra piattaforma ti offre opportunità ineguagliabili per creare. Inizia esplorando il Creator Hub, Roblox Studio e la nostra vibrante comunità di creatori.

La nostra piattaforma ti offre opportunità senza precedenti per creare.

La nostra comunità di sviluppatori pluripremiati e creatori autodidatti è nata qui, proprio come te. 

Un importante artista di ambienti su Roblox spiega come e perché utilizzare i pacchetti

Scopri come affrontare i problemi di prestazioni più comuni.

Un contenuto elaborato dallo staff su gravità, proprietà dei materiali e vincoli

Scopri cosa succede quando un utente si unisce a un'esperienza

I plugin aggiungono funzionalità aggiuntive alle tue creazioni

Visitiamo l'UGC Homestore di PolarCub! Incontreremo anche Temprist.

Scopri come indirizzare il traffico e far conoscere le tue creazioni

Scopri tutti i punti salienti dell'RDC di quest'anno

Scopri come vendere e promuovere articoli avatar con i suggerimenti degli esperti.

Scopri flussi di lavoro efficienti per creare articoli per avatar in Blender.

Madison_Hatter2 mostra come applicare texture a un semplice articolo per avatar e pubblicarlo.

Scopri cosa è possibile fare con il nostro motore di creazione

Impara a eseguire il rigging di un modello di personaggio umanoide R15

Crea e vendi il tuo primo accessorio rigido di base su Roblox

Ottieni un'anteprima di alcune delle nuove funzionalità e funzionalità che arriveranno presto a Roblox

Studio è lo strumento che ti consente di creare delle esperienze su Roblox

Scopri come utilizzare l'editor di script in Studio per creare degli script personalizzati

Andrew ti mostra dove posizionare i tuoi script, in modo che vengano eseguiti correttamente.

Lo scripting ti consente di aggiungere interazioni coinvolgenti per i tuoi utenti

Impara le scorciatoie di Studio e i comandi chiave per accelerare il processo di costruzione

Scopri come integrare le funzioni che consentono agli utenti di giocare con gli amici

Crea un annuncio sponsorizzato per ottenere la tua creazione di fronte a più creatori

Studio è uno strumento completo per costruire contenuti su Roblox. Prova a realizzare qualcosa oggi!

Scopri come offrire ai giocatori dei vantaggi ricorrenti a fronte di una quota mensile

Fai crescere la tua esperienza con l'aiuto di altri Creatori

Usa l'editor di terreno per generare e modificare il terreno in Studio

Esperienze come {boldStart}{experienceName}{boldEnd} hanno registrato un incremento medio dell'8,5% nel tasso di partecipazione qualificata con la personalizzazione.

Le traduzioni possono aiutare la tua creazione a raggiungere tonnellate di pubblico diverso

Scopri il nuovo modello UGC Homestore con Minty e SCHLEEMPH

Scopri come costruire dei contenuti per il pubblico specifico di Roblox

Cosa sono e come puoi usarli per costruire

Guarda una rapida introduzione al processo di creazione su Roblox, quindi passa a Studio

Leggi gli ultimi annunci dello Staff di Roblox

Gestisci e fai crescere le tue creazioni tutto in un unico posto conveniente

L'area di lavoro contiene gli oggetti che vuoi che il motore renderizzi all'interno del tuo progetto

Un contenuto elaborato dallo staff su parti, mesh, terreno e illuminazione

Aggiungi contenuti della community alla tua esperienza

Introduzione all'applicazione di texture per UGC con Madison_Hatter2

Presence v1

Models