> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# XblMultiplayerActivitySetActivityAsync

> XblMultiplayerActivitySetActivityAsync

# XblMultiplayerActivitySetActivityAsync

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

## 構文

```cpp theme={null}
HRESULT XblMultiplayerActivitySetActivityAsync(  
         XblContextHandle xblContext,  
         const XblMultiplayerActivityInfo* activityInfo,  
         bool allowCrossPlatformJoin,  
         XAsyncBlock* async  
)  
```

### パラメーター

*xblContext*   \_In\_\
型: [XblContextHandle](https://docs.xbox.com/ja-jp/reference/live/xsapi-c/types_c/handles/xblcontexthandle.md)

ローカル ユーザーの XBOX Live コンテキスト。

*activityInfo*   \_In\_\
型: [XblMultiplayerActivityInfo\*](https://docs.xbox.com/ja-jp/reference/live/xsapi-c/multiplayer_activity_c/structs/xblmultiplayeractivityinfo.md)

アクティビティに関する情報。`maxPlayers` および `currentPlayers` フィールドは省略可能です。これらが 0 に設定されている場合は無視されます。`platform` フィールドの値は無視されます。XSAPI は適切なローカル プラットフォームにアクティビティを自動的に設定します。

*allowCrossPlatformJoin*   \_In\_\
型: bool

タイトルがサポートする他のプラットフォームでもアクティビティを参加可能にする場合は True。

*async*   \_In\_\
型: XAsyncBlock\*

この操作用の `XAsyncBlock`。

### 戻り値

型: HRESULT

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

## 解説

タイトルがマルチプレイヤー エクスペリエンスを開始または参加するときは、アクティビティを作成する必要があります。これにより、シェルおよびタイトル内の他のプレイヤーがそのプレイヤーのアクティビティを確認できるようになります。タイトルは、進行中のゲームに他のプレイヤーが参加できるようにできます。プレイヤーがタイトルのアクティビティに参加しようとしたときにタイトルが実行されていない場合、タイトルがアクティブ化され、接続文字列がタイトルに渡されます。\
\
 この関数の使用方法については、[マルチプレイヤー アクティビティのサンプル コード](https://docs.xbox.com/ja-jp/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to.md) の [アクティビティ](https://docs.xbox.com/ja-jp/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to.md#activities) セクションにある「アクティビティの設定」を参照してください。

## REST 呼び出し

PUT /titles/{titleId}/users/{xuid}/activites を呼び出します

## 要件

**ヘッダー:** multiplayer\_activity\_c.h

**ライブラリ:** Microsoft.Xbox.Services.14x.GDK.C.lib

## 関連項目

[multiplayer\_activity\_c](https://docs.xbox.com/ja-jp/reference/live/xsapi-c/multiplayer_activity_c/multiplayer_activity_c_members.md)


## Related topics

- [XblMultiplayerActivityPlatform](https://docs.xbox.com/ja-jp/reference/live/xsapi-c/multiplayer_activity_c/enums/xblmultiplayeractivityplatform.md)
- [XblMultiplayerActivityInfo](https://docs.xbox.com/ja-jp/reference/live/xsapi-c/multiplayer_activity_c/structs/xblmultiplayeractivityinfo.md)
- [XblMultiplayerActivityJoinRestriction](https://docs.xbox.com/ja-jp/reference/live/xsapi-c/multiplayer_activity_c/enums/xblmultiplayeractivityjoinrestriction.md)
- [multiplayer_activity_c](https://docs.xbox.com/ja-jp/reference/live/xsapi-c/multiplayer_activity_c/multiplayer_activity_c_members.md)
- [MPSD から PlayFab Multiplayer と MPA への移行](https://docs.xbox.com/ja-jp/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)