ExperienceNotificationService
*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.
Notificações de experiência são uma maneira para 13+ usuários acompanharem suas experiências favoritas por meio de notificações personalizadas e oportunas.Este serviço contém métodos para validar usuários e solicitar que eles ativem notificações.
Resumo
Métodos
Mostra um aviso na experiência para o jogador local ativar notificações.
Indica se o jogador local pode ser solicitado a habilitar notificações.
Eventos
Dispara quando o jogador local fecha o prompt.
Propriedades
Métodos
PromptOptIn
PromptOptIn() solicita ao jogador local para habilitar notificações através de um modal na experiência.Você deve sempre usar o resultado de CanPromptOptInAsync() antes de chamar esse método, pois a capacidade de ser solicitado depende de vários fatores, como a idade do jogador ou se eles já ativaram notificações para sua experiência.
Este método sempre inferirá o jogador local (Players.LocalPlayer ) e só poderá ser chamado de um LocalScript ou de um Script com RunContext definido para Client .
Veja Notificações de experiência para mais detalhes sobre a implementação e personalização de notificações, usando dados de lançamento e muito mais.
Devolução
Amostras de código
local ExperienceNotificationService = game:GetService("ExperienceNotificationService")
-- Function to check whether the player can be prompted to enable notifications
local function canPromptOptIn()
local success, canPrompt = pcall(function()
return ExperienceNotificationService:CanPromptOptInAsync()
end)
return success and canPrompt
end
local canPrompt = canPromptOptIn()
if canPrompt then
local success, errorMessage = pcall(function()
ExperienceNotificationService:PromptOptIn()
end)
end
-- Listen to opt-in prompt closed event
ExperienceNotificationService.OptInPromptClosed:Connect(function()
print("Opt-in prompt closed")
end)CanPromptOptInAsync
CanPromptOptInAsync() retorna true se o jogador local puder ser solicitado a habilitar notificações.Você deve sempre usar o resultado deste método antes de chamar PromptOptIn() pois a capacidade de ser solicitado depende de vários fatores, como a idade do jogador ou se eles já habilitaram notificações para sua experiência.
Este método sempre inferirá o jogador local (Players.LocalPlayer ) e só poderá ser chamado de um LocalScript ou de um Script com RunContext definido para Client .Também deve ser chamado em um pcall() uma vez que é uma chamada de rede assíncrona que pode ocasionalmente falhar.
Veja Notificações de experiência para mais detalhes sobre a implementação e personalização de notificações, usando dados de lançamento e muito mais.
Devolução
Se o jogador local pode ser solicitado a habilitar notificações.
Amostras de código
local ExperienceNotificationService = game:GetService("ExperienceNotificationService")
-- Function to check whether the player can be prompted to enable notifications
local function canPromptOptIn()
local success, canPrompt = pcall(function()
return ExperienceNotificationService:CanPromptOptInAsync()
end)
return success and canPrompt
end
local canPrompt = canPromptOptIn()
if canPrompt then
local success, errorMessage = pcall(function()
ExperienceNotificationService:PromptOptIn()
end)
end
-- Listen to opt-in prompt closed event
ExperienceNotificationService.OptInPromptClosed:Connect(function()
print("Opt-in prompt closed")
end)Eventos
OptInPromptClosed
Este evento é disparado quando o jogador local fecha um prompt que foi exibido através de PromptOptIn() .Só pode ser conectado em um LocalScript ou em um Script com RunContext definido para Client.
Veja Notificações de experiência para mais detalhes sobre a implementação e personalização de notificações, usando dados de lançamento e muito mais.
Amostras de código
local ExperienceNotificationService = game:GetService("ExperienceNotificationService")
-- Function to check whether the player can be prompted to enable notifications
local function canPromptOptIn()
local success, canPrompt = pcall(function()
return ExperienceNotificationService:CanPromptOptInAsync()
end)
return success and canPrompt
end
local canPrompt = canPromptOptIn()
if canPrompt then
local success, errorMessage = pcall(function()
ExperienceNotificationService:PromptOptIn()
end)
end
-- Listen to opt-in prompt closed event
ExperienceNotificationService.OptInPromptClosed:Connect(function()
print("Opt-in prompt closed")
end)