> ## 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/zh-TW/reference/live/xsapi-c/types_c/handles/xblcontexthandle.md)

本機使用者的 XBOX Live 內容。

*activityInfo*   \_In\_\
類型：[XblMultiplayerActivityInfo\*](https://docs.xbox.com/zh-TW/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/zh-TW/services/xbox-services/multiplayer/mpa/how-to/live-mpa-client-how-to.md)中[活動](https://docs.xbox.com/zh-TW/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/zh-TW/reference/live/xsapi-c/multiplayer_activity_c/multiplayer_activity_c_members.md)


## Related topics

- [XblMultiplayerActivityPlatform](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_activity_c/enums/xblmultiplayeractivityplatform.md)
- [XblMultiplayerActivityInfo](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_activity_c/structs/xblmultiplayeractivityinfo.md)
- [XblMultiplayerActivityJoinRestriction](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_activity_c/enums/xblmultiplayeractivityjoinrestriction.md)
- [multiplayer_activity_c](https://docs.xbox.com/zh-TW/reference/live/xsapi-c/multiplayer_activity_c/multiplayer_activity_c_members.md)
- [從 MPSD 移至 PlayFab Multiplayer 與 MPA](https://docs.xbox.com/zh-TW/services/xbox-services/multiplayer/mpsd/concepts/live-mpsd-to-mlp.md)