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

Presence Api v1

userPresenceRequest

Visão geral

Experiências

Avatar

Ativos

Open Cloud

Criação

Descoberta

Localização

Dados analíticos

Design

Scale

Afiliados

Monetize

Este método é assíncrono e retorna uma "Operação", que representa o estado atual da operação. Ele contém um caminho de endpoint que você pode solicitar para obter a resposta real e os metadados aplicáveis. Veja o [documentation]({longRunningOperationsLink}) em operações de longo prazo para obter mais informações.
            
As seções a seguir descrevem os objetos de resposta e metadados que são fornecidos quando uma operação se completa.

Pontos de extremidade beta estão prontos para uso público. Alterações  danosas são possíveis mas raras.

Este campo pode ser definido ao criar um recurso, mas não pode ser modificado por solicitações subsequentes.

Esses campos podem ser definidos ao criar um recurso, mas não podem ser modificados por solicitações subsequentes.

Este campo pode ser fornecido em solicitações, mas nunca será incluído em respostas.

Por chave de API: {maxInPeriod} solicitações a cada {periodInSeconds} segundos por endereço IP

Este campo pode ser definido como respostas, mas será ignorado em solicitações.

As seguintes permissões de chave API são requeridas para chamar este endpoint. Para mais informações sobre gerar chaves apropriadas, veja [Gerenciando chaves API]({apiKeyReferenceDocLink}).

Os seguintes endpoints estão disponíveis em caminhos relativos à URL base.

Esta cadeia de caracteres está formatada como um [FieldMask](/cloud/reference/types#fieldmask).

Um valor JSON pode ser `null`, `boolean`, `string`, `number`, `array`, ou `object`.

Os seguintes escopos são necessários para que seu aplicativo OAuth 2.0 use este endpoint. Para obter mais informações sobre como registrar um aplicativo OAuth 2.0, consulte [Registro e revisão de aplicativos]({oauth2ReferenceDocLink}).

Os seguintes objetos descrevem payloads que são aceitos ou retornados. Veja cada endpoint para mais informações sobre quando esses objetos são usados.

Esta cadeia de caracteres é formatada como um [Timestamp](/cloud/reference/types#timestamp).

Os seguintes escopos são necessários para que sua aplicação OAuth 2.0 use este endpoint. Para obter mais informações sobre como registrar um aplicativo OAuth 2.0, consulte [Registro e revisão do aplicativo]({oauth2ReferenceDocLink}).

Isto permite visualizar informações sobre seus ativos.

Isto permite enviar e atualizar ativos para a Roblox.

Concede a capacidade de atualizar emblemas de propriedade do usuário.

Isso permite visualizar informações sobre seus itens de comércio.

Isso permite editar suas conexões de comerciante.

Isso permite que você visualize informações sobre seus produtos da Loja do Criador.

Isso permite que você modifique informações sobre seus produtos da Loja de Criadores.

Isso permite visualizar informações sobre suas comunidades

Isso permite que você gerencie solicitações de participação na comunidade e atualizações de cargos de membros da comunidade de níveis inferiores para sua conta.

Isto permite visualizar informações sobre seu inventário.

Concede acesso para gerenciar seus emblemas.

Concede acesso para gerenciar seus emblemas e gastar Robux.

Concede acesso para gerenciar seus produtos de desenvolvedor.

Concede acesso para ler informações sobre as experiências que você segue.

Concede acesso para seguir e deixar de seguir experiências em seu nome.

Concede acesso para gerenciar seus passes.

Concede acesso para gerenciar suas comunidades.

Concede permissão para ler informações da comunidade.

Concede permissões de gerenciamento de comunidade.

Concede acesso para ler e escrever suas tabelas de localização

Concede acesso para gerenciar a colaboração de equipe para todas as experiências que você possui.

Concede acesso para gerenciar suas experiências e certas informações associadas a suas experiências (por exemplo, informações de localização).

Concede acesso para ler as informações de localização das suas experiências.

Concede acesso para modificar as preferências de localização das suas experiências.

Concede acesso para gerenciar sua conta de usuário.

Concede acesso para modificar as preferências de localização do usuário.

Isto permite publicar mensagens em nome de um usuário.

Isto permite o envio de notificações da sua experiência aos usuários.

Isto permite listar segredos aliados à sua experiência.

Isto permite criar e atualizar segredos relacionados à sua experiência.

Concede acesso para ler sobre seus produtos de assinatura.

Concede a capacidade de ler informações do local.

Concede a capacidade de editar as informações do local.

Esta operação permite acesso para publicar novas versões de experiências para a Roblox.

Concede a capacidade de ler informações da experiência.

Concede a capacidade de editar informações da experiência.

Permite que você veja restrições de usuário na experiência.

Permite que você edite restrições de usuário na experiência.

Concede a capacidade de ler o status Premium e verificado do usuário.

Isso permite que você veja as contas sociais de um usuário.

Isto habilita a funcionalidade de entrada única.

Isso permite acesso à leitura das informações do seu perfil.

Valor padrão: {defaultValueStart}{defaultValueEnd}

Um array é uma lista ordenada de valores. Arrays são úteis para armazenar coleções de dados.

Um conjunto de pares chave-valor, onde as chaves podem ser qualquer número, string ou objeto.

Essa função retorna imediatamente, se possível, mas pode gerar a sequência que a chamou até que possa retornar um valor.

{nameStart}nome{nameEnd} não é mais suportado ou mantido pela Roblox.

Essa operação matemática não é mais suportada ou mantida pela Roblox.

Este membro não aparece no navegador de objetos e não é para uso geral.

Este membro só é acessível somente através da barra de comandos. Tentar acessar este membro a partir de scripts causa um erro.

Esta função não pode pausar o tópico Lua que a chamou.

Tentar acessar este membro em scripts causa um erro. Você pode ser capaz de acessar este membro na janela de propriedades do Roblox Studio.

Este membro não aparece no Navegador de Objetos do Roblox Studio.

Não é possível criar uma instância desta classe com o construtor Instance.new.

A Roblox não replica este membro além do limite do seu servidor-cliente.

O código Lua não pode acessar este membro. Você pode ser capaz de alterar o valor dele na janela de propriedades do Roblox Studio.

Este membro está acessível a partir das tarefas de execução do OpenCloud Luau.

O comportamento de replicação do objeto depende do jogador que o possui.

Este membro é acessível somente através da barra de comandos e plugins. Tentar acessar este membro a partir de scripts causa um erro.

Este membro é somente leitura. Tentar escrever para este membro causa um erro.

Esta propriedade é somente leitura e é segura para ler em tópicos não sincronizados. Tentar escrever nela causa um erro.

Esta propriedade é somente leitura e é segura para ler em threads não sincronizadas. Tentar escrever nela causa um erro.

Este membro é acessível somente no CoreScripts.

Somente o Roblox CoreScripts pode acessar este membro e ele não é utilizável por jogadores.

Você pode ler e escrever para esta propriedade com segurança a partir de várias threads.

Esta classe é uma singleton de alto nível. Recupere uma instância desta classe com a função GetService.

Várias threads podem potencialmente escrever para esta propriedade, então não é seguro ler a partir de threads não sincronizadas.

Você pode ler e escrever para esta propriedade com segurança a partir de vários tópicos.

Esta função pausa a thread Lua que a chamou até que ela retorne um resultado. Isto não interrompe outros scripts.

Gerencie e analise todas as suas experiências em um único lugar conveniente.

Aprenda com a documentação e recursos para todos os criadores.

Aprenda a criar experiências Roblox com guias, tutoriais e amostras de código.

Construa suas experiências no Studio, nosso ambiente de desenvolvimento integrado (também chamado pela sigla em inglês IDE) e distribua-as para uma grande variedade de dispositivos.

Maneiras confiáveis de oferecer valor ao longo do tempo ao seu público

Aprenda a criar anúncios de sucesso que geram tráfego para suas criações

Trace o crescimento da sua experiência e descubra oportunidades para melhorar

Aprenda a aplicar movimento aos seus personagens e ambientes

Aprenda como fazer upload ou usar ativos da Loja em suas criações

Criar itens de avatar e publicá-los no mercado

Ordenado pela maior receita nos últimos 7 dias

Aprenda sobre o que você pode fazer e vender no mercado

O avatar representa cada usuário da Roblox como um personagem personalizável

Veja este tópico de criações legais sendo construídas pela comunidade

Aprenda técnicas básicas de modelagem no Blender

Encontre modelos, scripts e plugins feitos por outros criadores

Aprenda como criar gaiolas para seus itens de avatar com um artista 3D da Roblox

Aprenda como configurar personagens para garantir que todas as funções do avatar funcionem corretamente

Aprenda a criar objetos que interagem com o mundo ou com outros usuários

Faça e venda seu primeiro item básico de roupa na Roblox

Use as ferramentas de colaboração do Studio para trabalhar com sua equipe ao mesmo tempo

Veja o que está em alta no Mercado de Criações

Confira o que está em alta na Loja do Criador

Participe de eventos comunitários realizados por outros criadores

Encontre tutoriais escritos pela comunidade de criadores

Mantenha os jogadores engajados e monetizados com atualizações de conteúdo

Capture seu público com um ciclo de jogabilidade agradável

Impulsione o engajamento e o progresso com uma jogabilidade divertida e repetitiva

Aprenda a criar uma porta deslizante sem escrever nenhum código

Alex compartilha a experiência em primeira mão por trás da criação da experiência de sucesso, JailBreak

Blake encontrou uma paixão em fazer jogos de parques de diversão realistas e extravagantes

The Clemens é o estúdio de propriedade da família por trás de sucessos como O Jogo de Sobrevivência

Jasmine é a artista por trás de alguns dos itens de avatar mais populares no Mercado

Jessica é a designer por trás dos ambientes imaginativos de jogos, como no Alo Yoga

Jenni é o criador e artista de CGUs por trás de muitas colaborações populares

O estilo único do Morphist combina estética fofa e emo

Os criadores do Riotfall viajam para encontrar inspiração para seus ambientes imersivos

Stephen compartilha seu amor por ferramentas de programação

Sam compartilha como eles começaram a projetar itens de moda que eles gostariam que existissem

Todos os objetos que compõem um mundo 3D, como peças e iluminação

Aprenda sobre a gama de ferramentas de depuração disponíveis no Studio

Veja seu progresso em direção ao seu próximo saque!

Use o console do desenvolvedor para depurar sua experiência ao testar

Adicionar assinaturas à sua experiência ajuda a construir relacionamentos a longo prazo com sua base de usuários. Habilite assinaturas antes de 15 de dezembro de 2023 e desfrute de 3 meses de taxas mais baixas.

Visite as principais experiências para obter inspiração

Comece com o Studio, o motor de criação da Roblox

Adicione algumas linhas de código para desbloquear novos painéis para entender sua integração e outros funis e acompanhar sua economia no jogo.

A Minty ensina o Enyu sobre geometria sólida construtiva.

Construa eventos ao vivo, entre servidores e cenas em uma sequência estruturada

Aprenda a criar eventos temporizados para suas experiências

Crie eventos baseados no tempo para aumentar a visibilidade no Roblox. Anuncie sua última atualização, destaque uma atividade ou celebre um marco com seus jogadores!

Saiba como direcionar o grupo etário para a sua criação através das diretrizes de experienciados

Ganhe conhecimento e experiência diretamente da Roblox

Saiba como implementar um sistema de recompensa de convite de amigos

Aprenda como você pode controlar como seus dados são usados para treinar IA. {linkStart}Leia Mais{linkEnd}

Crie texturas personalizadas facilmente usando nossas ferramentas de IA

Use nosso motor de criação tudo-em-um para construir qualquer coisa que você possa imaginar

PolarCub compartilha todas as dicas e truques para fazer itens CGU

Use o Guilded para construir uma comunidade para sua criação

Junte-se ao nosso incrível elenco de criadores para uma Game Jam do Dia das Bruxas

Use a parte da cabeça para criar animações faciais ou ativar emotes

Usando métricas para entender onde você pode melhorar sua jogabilidade

Entenda como mantê-los voltando ao seu jogo

A entrada do usuário permite que os usuários interajam com o ambiente da sua experiência

Guie os jogadores pela primeira vez que eles jogarem em sua experiência

Crie roupas que se esticam e se encaixam no corpo de qualquer avatar

Na Roblox, acreditamos que você aprende melhor fazendo. Escolha um de nossos guias para explorar mais do que a plataforma oferece.

Obtenha ajuda escrevendo código e respostas para suas perguntas de criação

Os serviços de Luz e Som permitem que você controle os efeitos ambientais

Aprenda a adaptar seu conteúdo a diferentes idiomas e normas culturais

Este guia abrange anexos, vigas e alguns conceitos básicos de escrita que te mostram como colocar a saúde do jogador como 0 se tocarem em algo

Como experimentar rapidamente com novas ideias

Cultivar uma base de jogadores ativa é uma parte fundamental do desenvolvimento de um jogo bem-sucedido e duradouro.

Aprenda sobre a otimização de desempenho e a ferramenta de solução de problemas

O Microprofiler fornece informações de tempo para o agendador de tarefas

Mergulhe fundo nas cores da moldura, nos gráficos de fogo e mais

Entenda como usar métricas para ser mais bem-sucedido

Melhorar o desempenho de scripts Luau de intensidade computacional

Veja seus valores de referência diários, dicas e métricas em tempo real para levar {boldStart}{experienceName}{boldEnd} para o próximo nível.

Aprenda a usar NPCs (personagens não-jogadores) em suas experiências

@minty cria uma obby ao vivo do zero usando sugestões do chat

Nossa plataforma oferece oportunidades inigualáveis para você criar. Comece explorando a Central de Criadores, o Roblox Studio e nossa vibrante comunidade de criadores.

Nossa plataforma oferece oportunidades inigualáveis para você criar.

Nossa comunidade de estúdios premiados e criadores autodidatas começou aqui, assim como você. 

Um artista de ambiente principal na Roblox cobre como e por que usar pacotes

Aprenda a lidar com os problemas de desempenho mais comuns.

Fluxo de equipe sobre gravidade, propriedades dos materiais e restrições

Aprenda sobre o que acontece quando um usuário entra em uma experiência

Plugins adicionam funcionalidades adicionais às suas criações

Vamos passear pela Loja CGU de PolarCub! Além disso, Temprist aparece.

Aprenda a gerar tráfego e conscientização para suas criações

Obtenha todos os destaques da RDC deste ano

Saiba como vender e promover itens de avatar com informações de especialistas.

Aprenda fluxos de trabalho eficientes para criar itens de avatar em Blender.

Madison_Hatter2 mostra como texturizar e publicar um item de avatar simples.

Saiba mais sobre o que é possível com nosso motor de criação

Aprenda como construir um modelo de personagem humanoide R15

Faça e venda seu primeiro acessório rígido básico na Roblox

Obtenha uma prévia de alguns dos novos recursos e capacidades que estão chegando na Roblox

O Studio é a ferramenta que permite criar experiências na Roblox

Aprenda a usar o editor de scripts no Studio para criar scripts personalizados

O Andrew mostra onde colocar seus scripts, para que eles sejam executados corretamente.

O script permite adicionar interações imersivas para seus usuários

Aprenda atalhos do Studio e comandos de tecla que tornam a construção mais rápida

Aprenda como integrar funcionalidades que permitem que os jogadores joguem com amizades

Crie um anúncio patrocinado para levar sua criação para mais criadores

O Studio é uma ferramenta tudo-em-um para construir na Roblox. Tente criar algo hoje!

Aprenda a oferecer benefícios recorrentes aos jogadores por uma taxa mensal

Aumente sua experiência com a ajuda de outros criadores

Use o editor de terreno para gerar e alterar o terreno no Studio

Experiências como {boldStart}{experienceName}{boldEnd} viram uma média de aumento de +8.5% em jogadas qualificadas com personalização.

As traduções podem ajudar sua criação a alcançar muitos públicos diferentes

Visite o novo modelo de CGU Homestore com Minty e SCHLEEMPH

Aprenda a construir para o público exclusivo da Roblox

O que são e como você pode usá-los para construir

Assista a uma introdução rápida à criação na Roblox e depois entre no Studio

Leia os anúncios mais recentes da Equipe Roblox

Gerencie e desenvolva suas criações, tudo em um lugar conveniente

A área de trabalho contém objetos que você deseja que o mecanismo renderize em seu projeto

Fluxo de equipe cobrindo peças, malhas, terreno e iluminação

Adicionar conteúdo da comunidade à sua experiência

Introdução à texturação para CGU com Madison_Hatter2

Presence v1

Models