Skip to main content

XGameUiShowSendGameInviteAsync

此方法会显示一个从所选玩家的好友列表和推荐好友列表中填充的选择器 UI,用于发送游戏邀请。

语法

参数

async _In_
类型:XAsyncBlock*
指向传递给 XAsyncRunXAsyncBlock 的指针。 requestingUser _In_
类型:XUserHandle
发送邀请的用户的句柄。 sessionConfigurationId _In_
类型:char*
指定一个字符串,用于表明该游戏的服务配置 ID。 sessionTemplateName _In_
类型:char*
指定一个字符串,用于表明多人游戏会话模板的名称。 sessionId _In_
类型:char*
指定一个字符串,用于表明要邀请他人加入的多人游戏会话的 ID。 invitationText _In_opt_
类型:char*
指定一个字符串,用于表明自定义邀请字符串 ID。
此字符串 ID 定义在 XBOX Live 服务配置中,用于标识除标准邀请文本之外的附加邀请文本。ID 字符串必须以 “///” 作为前缀。如果不希望在邀请中添加自定义字符串,请传入空字符串。
customActivationContext _In_opt_
类型:char*
在邀请的激活 URI 中提供给受邀者的自定义激活上下文。自定义激活上下文字符串必须是 URL 安全的,二进制内容应使用 URL 安全的 base64 编码。最大长度为 160 个字符。

返回值

类型: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日