ExperienceNotificationService
*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
エクスペリエンス通知 は、13以上のユーザーが、タイムリーでパーソナライズされた通知で、お気に入りのエクスペリエンスについて最新情報を取得できる方法です。このサービスには、ユーザーを検証し、通知を有効にするよう求める方法が含まれています。
概要
方法
ローカルプレイヤーに通知を有効にするための体験中のプロンプを表示します。
ローカルプレイヤーが通知を有効にするように求められるかどうかを示します。
イベント
ローカルプレイヤーがプロンプトを閉じると発火します。
プロパティ
方法
PromptOptIn
PromptOptIn() ローカルプレイヤーに、エクスペリエンス内のモーダルを通じて通知を有効にするよう促します。このメソッドを呼び出す前に、CanPromptOptInAsync() の結果を常に使用する必要があります。この機能は、プレイヤーの年齢やエクスペリエンスに通知を有効にしているかどうかなど、さまざまな要因に依存しています。
このメソッドは常に ローカルプレイヤー ( ) を推測し、 または で に設定された からのみ呼び出すことができます。
ランチデータを使用して通知を実装およびカスタマイズする方法など、詳細は エクスペリエンス通知 を参照してください。
戻り値
コードサンプル
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() は、ローカルプレイヤーが通知を有効にするように促される場合、true を返します。このメソッドの結果を常に使用する必要がありますPromptOptIn() 、呼び出し前に、プレイヤーの年齢やエクスペリエンスに通知を有効にしているかどうかなど、さまざまな要因によって通知が表示されるかどうかが決まるからです。
このメソッドは常に ローカルプレイヤー ( ) を推測し、 または で に設定された からのみ呼び出すことができます。また、非同期ネットワーク呼び出しであるため、pcall() で呼び出されるべきです、ときどき失敗する可能性があります。
ランチデータを使用して通知を実装およびカスタマイズする方法など、詳細は エクスペリエンス通知 を参照してください。
戻り値
ローカルプレイヤーが通知を有効にするように求められるかどうか。
コードサンプル
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)
イベント
OptInPromptClosed
このイベントは、ローカルプレイヤーが PromptOptIn() を通じて表示されたプロンプトを閉じたときに発動します。接続できるのは、LocalScript または Script で、RunContext を Client に設定した状態でのみです。
ランチデータを使用して通知を実装およびカスタマイズする方法など、詳細は エクスペリエンス通知 を参照してください。
コードサンプル
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)