メインコンテンツへスキップ
この記事では、XBOX services API (XSAPI) を使用してタイトル プレゼンスの変更を処理するサンプル コードを提供します。タイトル プレゼンスの通知を受け取るには、まずハンドラーを登録してから、関心のあるユーザーとタイトルを追跡します。通知が不要になったら、ユーザーとタイトルの追跡を停止し、ハンドラーを削除します。 この例では、xboxLiveContext はサインインしているローカル ユーザーの XblContextHandle、state はハンドラー トークンを格納するタイトル定義のオブジェクト、LogToFile はタイトル定義のログ関数です。123 はプレゼンスを追跡するユーザーの XBOX ユーザー ID (XUID) に、otherTitleId は追跡する別のタイトルのタイトル ID に置き換えてください。
XblPresenceSubscribeToTitlePresenceChange と XblPresenceUnsubscribeFromTitlePresenceChange は非推奨です。新しいコードでは使用しないでください。XblPresenceTrackUsers でユーザーを、XblPresenceTrackAdditionalTitles でタイトルを追跡すると、XSAPI が Real-Time Activity (RTA) サブスクリプションを自動的に管理します。

タイトル プレゼンス変更ハンドラーの追加

ユーザーとタイトルを追跡する前にハンドラーを登録します。xblContextHandle または handler が null の場合、この関数は 0 を返します。
詳細については、 XblPresenceTitleState を参照してください。

ユーザーとタイトルの追跡

タイトル プレゼンス変更ハンドラーは、XblPresenceTrackUsers で追跡しているユーザーと、追跡しているタイトルについてのみ通知を受け取ります。現在のタイトルは既定で追跡されるため、XblPresenceTrackAdditionalTitles は他のタイトルに対してのみ呼び出してください。呼び出しのたびに、既存の一覧に追加されます。各呼び出しの結果を確認してください。
追跡は参照カウントされます。成功した追跡の呼び出しごとに、対応する停止の呼び出しを行ってください。追跡対象ユーザーの一覧は、デバイス プレゼンスとタイトル プレゼンスの両方の通知に適用されます。

ユーザーとタイトルの追跡の停止

タイトル プレゼンスの更新が不要になったら、追跡していたタイトルとユーザーの追跡を停止し、それぞれの結果を確認します。XblPresenceStopTrackingAdditionalTitles では、現在のタイトルの追跡は停止されません。

タイトル プレゼンス変更ハンドラーの削除

XblPresenceAddTitlePresenceChangedHandler が返したトークンを渡して、ハンドラーを削除します。格納しているトークンは、呼び出しが成功した後にのみクリアしてください。

関連項目

XblPresenceAddTitlePresenceChangedHandler XblPresenceRemoveTitlePresenceChangedHandler XblPresenceTrackUsers XblPresenceTrackAdditionalTitles XblPresenceStopTrackingAdditionalTitles デバイス プレゼンス変更の処理
最終更新日 2026年10月30日