Skip to main content

XblMultiplayerActivitySetActivityAsync

为本地用户设置或更新多人游戏活动。

语法

参数

xblContext   _In_
类型:XblContextHandle
本地用户的 XBOX Live 上下文。 activityInfo   _In_
类型:XblMultiplayerActivityInfo*
有关活动的信息。maxPlayerscurrentPlayers 字段是可选的;如果设置为 0,则会被忽略。platform 字段的值会被忽略;XSAPI 会自动在相应的本地平台上设置活动。 allowCrossPlatformJoin   _In_
类型:bool
如果活动应可在标题支持的其他平台上加入,则为 True。 async   _In_
类型:XAsyncBlock*
此操作的 XAsyncBlock

返回值

类型:HRESULT 此 API 操作的 HRESULT 返回代码。

备注

当标题启动或加入多人游戏体验时,它应创建一个活动。这样做可让 Shell 以及标题中的其他玩家看到该玩家的活动。你的标题可以允许其他玩家加入正在进行的游戏。如果玩家想加入你标题的某个活动而该标题未在运行,则会激活该标题并将连接字符串传递给它。

若要了解如何使用此函数,请参阅多人游戏活动的示例代码活动部分中的“设置活动”。

REST 调用

调用 PUT /titles//users//activites

要求

头文件: multiplayer_activity_c.h 库: Microsoft.Xbox.Services.14x.GDK.C.lib

另请参阅

multiplayer_activity_c
最后修改于 2026年8月24日