PFAuthenticationLoginWithSteamRequest

PFAuthenticationLoginWithSteamRequest 資料模型。Steam 登入是使用 Steam 工作階段票證來完成。如需票證的詳細資訊，請參閱 Steamworks SDK：https://partner.steamgames.com/documentation/auth. 注意：若要讓 Steam 驗證正常運作，必須在 PlayFab Game Manager 中 (於附加元件市集的 Steam 下) 為遊戲設定 Steam 應用程式識別碼和 Web API 金鑰。您可以從 Steamworks 網站中與您的 App ID 相關聯之任何群組的 [權限] 頁面取得 Web API 金鑰。如果這是使用者第一次使用 Steam 帳戶登入，且 CreateAccount 設定為 true，系統將會建立新的 PlayFab 帳戶，並將其連結至所提供帳戶的 Steam ID。在此情況下，不會有任何電子郵件或使用者名稱與該 PlayFab 帳戶相關聯。否則，如果沒有任何 PlayFab 帳戶連結至 Steam 帳戶，將會傳回指出此情況的錯誤，讓遊戲可以引導使用者建立 PlayFab 帳戶。

語法

typedef struct PFAuthenticationLoginWithSteamRequest {  
    bool createAccount;  
    PFStringDictionaryEntry const* customTags;  
    uint32_t customTagsCount;  
    PFGetPlayerCombinedInfoRequestParams const* infoRequestParameters;  
    const char* playerSecret;  
    const char* steamTicket;  
    bool const* ticketIsServiceSpecific;  
} PFAuthenticationLoginWithSteamRequest;  

成員

createAccount bool 如果目前沒有 PlayFab 帳戶連結至此識別碼，則自動建立一個。 customTags PFStringDictionaryEntry const*
may be nullptr （選擇性）與要求相關聯的選擇性自訂標籤（例如組建編號、外部追蹤識別碼等）。 customTagsCount uint32_t customTags 的計數 infoRequestParameters PFGetPlayerCombinedInfoRequestParams const*
may be nullptr （選擇性）指定要為使用者傳回哪些資訊的旗標。 playerSecret const char*
is null-terminated （選擇性）用來驗證 API 要求簽章的玩家密碼。 steamTicket const char*
is null-terminated 使用者的驗證權杖，由 Steam 以位元組陣列傳回，並轉換為字串 (例如，位元組 0x08 應變成 “08”)。 ticketIsServiceSpecific bool const*
may be nullptr （選擇性）如果票證是使用 ISteamUser::GetAuthTicketForWebAPI() 並以 “AzurePlayFab” 作為身分識別字串所產生，則為 True。如果票證是使用 ISteamUser::GetAuthSessionTicket() 產生，則為 False。

需求

標頭： PFAuthenticationTypes.h

另請參閱

PFAuthenticationTypes 成員

最後修改於 2026年10月6日

⌘I

PlayFab API

PlayFab REST API References

PFAuthenticationLoginWithSteamRequest

語法

成員

需求

另請參閱

​語法

​成員

​需求

​另請參閱

語法

成員

需求

另請參閱