API 參考資料

本頁面列出 Google Play 遊戲電腦版 SDK for Unity API 中提供的類別、介面、結構體和列舉。

命名空間：PlayPcSdkManaged.Initialization

處理 Unity 遊戲與 Play Games 電腦版 SDK 執行階段之間的連線生命週期。

類別

類型	名稱	說明
Class	GooglePlayInitialization	SDK 的靜態進入點。包含非同步初始化連線的方法。
Class	InitializeResult	代表初始化作業的結果。

列舉

類型	名稱	說明
Enum	InitializationError	初始化期間傳回的錯誤代碼，例如 SdkRuntimeUnavailable 和 SdkRuntimeUpdateRequired。

命名空間：PlayPcSdkManaged.Billing

可存取 Google Play 帳款服務功能，包括應用程式內購 (IAP) 和訂閱項目。

類別

客戶和結果

類型	名稱	說明
Class	BillingClient	與 Billing 服務互動的主要用戶端。管理原生 C++ 連線，且必須處置。
Class	QueryProductDetailsResult	QueryProductDetailsAsync 傳回的結果。成功時，內含產品詳細資料清單。
Class	LaunchPurchaseFlowResult	LaunchPurchaseFlowAsync 傳回的結果。成功後會顯示購買詳細資料。
Class	QueryPurchasesResult	QueryPurchasesAsync 傳回的結果。包含使用者擁有的購買項目清單。
Class	AcknowledgePurchaseResult	AcknowledgePurchaseAsync 傳回的結果。
Class	ConsumePurchaseResult	ConsumePurchaseAsync 傳回的結果。

Structs

參數和模型

類型	名稱	說明
Struct	QueryProductDetailsParams	查詢產品詳細資料的輸入參數，內含產品 ID 清單。
Struct	LaunchPurchaseFlowParams	啟動購買交易的輸入參數，包括 OfferToken、Quantity 和經過模糊處理的 ID。
Struct	AcknowledgePurchaseParams	確認購買交易的輸入參數，需要 PurchaseToken。
Struct	ConsumePurchaseParams	用於消耗購買交易的輸入參數，需要 PurchaseToken。
Struct	ProductId	代表產品 ID 及其類型 (InApp 或 Subs)。
Struct	ProductDetails	產品的詳細資訊，包括名稱、說明和可用的優惠。
Struct	ProductOffer	代表產品的特定定價方案，包括 FormattedPrice 和 OfferToken。
Struct	ProductPurchaseDetails	交易詳細資料，包括 OrderId、PurchaseState 和 PurchaseToken。

列舉

類型	名稱	說明
Enum	BillingError	代表帳單作業結果的狀態碼，例如 Ok、UserCanceled 和 ItemAlreadyOwned。
Enum	ProductType	定義產品類型：InApp (1) 或 Subs (訂閱)。
Enum	PurchaseState	購買交易的狀態：Unspecified (0)、Purchased (1) 或 Pending (2)。

命名空間：PlayPcSdkManaged.Integrity

提供 Play Integrity API 的存取權，用於防範濫用和偵測詐欺行為。

類別

客戶和結果

類型	名稱	說明
Class	IntegrityClient	與 Integrity API 互動的主要用戶端。管理原生 C++ 連線，且必須處置。
Class	PrepareIntegrityTokenResult	PrepareIntegrityTokenAsync 傳回的結果。
Class	RequestIntegrityTokenResult	RequestIntegrityTokenAsync 傳回的結果。成功時，會包含已簽署的權杖位元組。

結構 (參數和模型)

類型	名稱	說明
Struct	PrepareIntegrityTokenParams	準備步驟的輸入參數，需要 CloudProjectNumber。
Struct	RequestIntegrityTokenParams	要求步驟的輸入參數，需要 RequestTokenData 和 RequestHash。
Struct	RequestTokenData	準備步驟傳回的中繼資料 (包含 WarmUpSessionId)，後續要求需要用到。

列舉

類型	名稱	說明
Enum	IntegrityError	代表完整性作業結果的狀態碼，例如 Ok、CloudProjectNumberIsInvalid 和 NetworkError。

命名空間：PlayPcSdkManaged.InstallReferrer

提供 Play Install Referrer API 的存取權，讓遊戲識別從 Google Play 商店推薦安裝的來源。

類別

客戶和結果

類型	名稱	說明
Class	InstallReferrerClient	與安裝參照服務互動的主要用戶端。管理原生 C++ 連線，且必須處置。
Class	GetInstallReferrerResult	GetInstallReferrerAsync 傳回的結果。成功時包含推薦資訊。

Structs

模型

類型	名稱	說明
Struct	GetInstallReferrerResultValue	代表查詢的成功結果，包含 InstallReferrer 字串和 InstallTimeEpochSeconds。

列舉

類型	名稱	說明
Enum	InstallReferrerError	代表安裝參照網址作業結果的狀態碼，例如 Ok 和 Error。

命名空間：PlayPcSdkManaged.Recall

提供 Play 遊戲服務 Recall API 的存取權，可讓您將遊戲內帳戶連結至 Google Play Games 服務帳戶。

類別

客戶和結果

類型	名稱	說明
Class	RecallClient	與 Recall 服務互動的主要用戶端。管理原生 C++ 連線，且必須處置。
Class	RequestRecallAccessResult	RequestRecallAccessAsync 傳回的結果。成功時，會包含回想工作階段 ID。

Structs

模型

類型	名稱	說明
Struct	RequestRecallAccessResultValue	代表存取要求成功，內含 RecallSessionId。

列舉

類型	名稱	說明
Enum	GamesRecallError	代表召回作業結果的狀態碼，例如 Ok 和 Error。

命名空間：PlayPcSdkManaged.Unity

適用於 SDK 的 Unity 專用輔助程式和轉接程式。

類別

類型	名稱	說明
Class	PlayPcSdkFactory	用於建立 BillingClient、IntegrityClient、InstallReferrerClient 和 RecallClient 例項，以及擷取 InitializationHandler 的工廠類別。這個類別會處理 Unity 專屬的回呼產生作業。

命名空間：PlayPcSdkManaged.Core

SDK 模組共用的核心基礎架構。

類別

類型	名稱	說明
Class	Result<TError, TValue>	所有 API 結果的基礎類別。提供 IsOk、Code、ErrorMessage 和 Value 屬性。