Skip to main content

XGameUiShowSendGameInviteAsync

このメソッドは、選択されたプレイヤーのフレンド リストおよび推奨フレンド リストから作成されたピッカー UI を表示し、ゲーム招待を送信できるようにします。

構文

パラメーター

async _In_
Type: XAsyncBlock*
XAsyncRun に渡される XAsyncBlock へのポインター。 requestingUser _In_
Type: XUserHandle
招待を送信するユーザーへのハンドル。 sessionConfigurationId _In_
Type: char*
タイトルのサービス構成 ID を示す文字列を指定します。 sessionTemplateName _In_
Type: char*
マルチプレイヤー セッション テンプレートの名前を示す文字列を指定します。 sessionId _In_
Type: char*
招待するマルチプレイヤー セッションの ID を示す文字列を指定します。 invitationText _In_opt_
Type: char*
カスタム招待文字列 ID を示す文字列を指定します。
この文字列 ID は、標準の招待テキストに追加される招待テキストを識別するために XBOX Live サービス構成で定義されます。ID 文字列の先頭には「///」を付ける必要があります。招待にカスタム文字列を追加したくない場合は空の文字列を渡します。
customActivationContext _In_opt_
Type: char*
招待のアクティブ化 URI で招待相手が利用できるカスタム アクティブ化コンテキスト。カスタム アクティブ化コンテキスト文字列は URL セーフである必要があり、バイナリ コンテンツは URL セーフ base64 エンコードでエンコードする必要があります。最大長は 160 文字です。

戻り値

Type: HRESULT 非同期呼び出しの HRESULT 成功またはエラー コード。

解説

リストが作成されたら、プレイヤーを選択できます。プレイヤーは、ピッカー UI で選択された個人に対して、指定されたゲーム セッションのプレイやパーティ チャットの招待を送信できます。 UI を呼び出すと、ゲームは 制約付きモード に入ります。制約付きモードでは、呼び出された UI のバックグラウンドにある間、タイトルが受け取るシステム リソースが少なくなります。制約付きモードやタイトルのその他の運用モードの詳細については、「XBOX ゲーム ライフ サイクル (NDA トピック)」を参照してください。

要件

ヘッダー: XGameUI.h ライブラリ: xgameruntime.lib サポートされているプラットフォーム: Windows、Steam Deck、XBOX One ファミリー本体および XBOX Series 本体

概念ドキュメント

関連項目

XGameUI
XGameUiShowSendGameInviteResult
XBOX ゲーム ライフ サイクル (NDA トピック)
最終更新日 2026年8月24日