Skip to main content

XblMultiplayerActivitySetActivityAsync

ローカル ユーザーのマルチプレイヤー アクティビティを設定または更新します。

構文

パラメーター

xblContext   _In_
型: XblContextHandle
ローカル ユーザーの XBOX Live コンテキスト。 activityInfo   _In_
型: XblMultiplayerActivityInfo*
アクティビティに関する情報。maxPlayers および currentPlayers フィールドは省略可能です。これらが 0 に設定されている場合は無視されます。platform フィールドの値は無視されます。XSAPI は適切なローカル プラットフォームにアクティビティを自動的に設定します。 allowCrossPlatformJoin   _In_
型: bool
タイトルがサポートする他のプラットフォームでもアクティビティを参加可能にする場合は True。 async   _In_
型: XAsyncBlock*
この操作用の XAsyncBlock

戻り値

型: HRESULT この API 操作の HRESULT 戻り値コード。

解説

タイトルがマルチプレイヤー エクスペリエンスを開始または参加するときは、アクティビティを作成する必要があります。これにより、シェルおよびタイトル内の他のプレイヤーがそのプレイヤーのアクティビティを確認できるようになります。タイトルは、進行中のゲームに他のプレイヤーが参加できるようにできます。プレイヤーがタイトルのアクティビティに参加しようとしたときにタイトルが実行されていない場合、タイトルがアクティブ化され、接続文字列がタイトルに渡されます。

この関数の使用方法については、マルチプレイヤー アクティビティのサンプル コードアクティビティ セクションにある「アクティビティの設定」を参照してください。

REST 呼び出し

PUT /titles//users//activites を呼び出します

要件

ヘッダー: multiplayer_activity_c.h ライブラリ: Microsoft.Xbox.Services.14x.GDK.C.lib

関連項目

multiplayer_activity_c
最終更新日 2026年8月24日