PFAuthenticationLoginWithSteamAsync

使用 Steam 身份验证票证使用户登录,并返回会话标识符,该标识符随后可用于需要经过身份验证的用户的 API 调用。

语法

HRESULT PFAuthenticationLoginWithSteamAsync(  
    PFServiceConfigHandle serviceConfigHandle,  
    const PFAuthenticationLoginWithSteamRequest* request,  
    XAsyncBlock* async  
)  

参数

serviceConfigHandle PFServiceConfigHandle

从 PFServiceConfigCreateHandle 调用返回的 PFServiceConfigHandle。

request PFAuthenticationLoginWithSteamRequest*

已填充的请求对象。

async XAsyncBlock*
Inout

异步操作的 XAsyncBlock。

返回值

类型:HRESULT

此 API 操作的结果代码。

备注

此 API 在 Win32、Linux 和 macOS 上可用。 Steam 登录是使用 Steam 会话票证完成的。 有关票证的详细信息,请参阅此处的 Steamworks SDK:https://partner.steamgames.com/documentation/auth。注意:若要使 Steam 身份验证正常工作,必须在 PlayFab Game Manager(位于加载项市场中的“Steam”下)中使用 Steam 应用程序 ID 和 Web API 密钥配置游戏。 可以从 Steamworks 网站中与应用 ID 关联的任何组的“权限”页获取 Web API 密钥。 如果这是用户首次使用 Steam 帐户登录,并且 CreateAccount 设置为 true,则将创建新的 PlayFab 帐户并将其链接到提供的帐户的 Steam ID。 在这种情况下,不会将任何电子邮件或用户名与 PlayFab 帐户关联。 否则,如果没有 PlayFab 帐户链接到 Steam 帐户,则会返回一个错误,指示将返回此帐户,以便游戏可以指导用户完成 PlayFab 帐户的创建。 另请参阅 ClientLinkSteamAccountAsync、ClientUnlinkSteamAccountAsync。 异步任务完成后,调用 PFAuthenticationLoginWithSteamGetResult 以获取结果。

要求

标头:PFAuthentication.h

另请参阅

PFAuthentication 成员