API 参考文档

本页列出了 Google Play Games PC SDK for Unity API 中提供的类、接口、结构体和枚举。

命名空间：PlayPcSdkManaged.Initialization

处理 Unity 游戏与 Play Games PC SDK 运行时之间的连接生命周期。

类

类型 名称 说明
Class GooglePlayInitialization SDK 的静态入口点。包含用于异步初始化连接的方法。
Class InitializeResult 表示初始化操作的结果。

枚举

类型 名称 说明
Enum InitializationError 初始化期间返回的错误代码，例如 SdkRuntimeUnavailable 和 SdkRuntimeUpdateRequired。

命名空间：PlayPcSdkManaged.Billing

提供对 Google Play 结算功能的访问权限，包括应用内购商品 (IAP) 和订阅。

类

客户端和结果

类型 名称 说明
Class BillingClient 用于与结算服务互动的主要客户端。管理原生 C++ 连接，必须进行处置。
Class QueryProductDetailsResult QueryProductDetailsAsync 返回的结果。成功时包含商品详情列表。
Class LaunchPurchaseFlowResult LaunchPurchaseFlowAsync 返回的结果。成功时包含购买详情。
Class QueryPurchasesResult QueryPurchasesAsync 返回的结果。包含用户拥有的购买商品列表。
Class AcknowledgePurchaseResult AcknowledgePurchaseAsync 返回的结果。
Class ConsumePurchaseResult ConsumePurchaseAsync 返回的结果。

结构体

参数和模型

类型 名称 说明
Struct QueryProductDetailsParams 用于查询商品详情的输入参数，包含商品 ID 列表。
Struct LaunchPurchaseFlowParams 用于启动购买的输入参数，包括 OfferToken、Quantity 和混淆的 ID。
Struct AcknowledgePurchaseParams 用于确认购买的输入参数，需要 PurchaseToken。
Struct ConsumePurchaseParams 用于使用购买商品的输入参数，需要 PurchaseToken。
Struct ProductId 表示商品标识符及其类型（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 的访问权限，该 API 可让您的游戏识别将安装引荐自 Google Play 商店的来源。

类

客户端和结果

类型 名称 说明
Class InstallReferrerClient 用于与 Install Referrer 服务互动的主要客户端。管理原生 C++ 连接，必须进行处置。
Class GetInstallReferrerResult GetInstallReferrerAsync 返回的结果。成功时包含引荐信息。

结构体

模型

类型 名称 说明
Struct GetInstallReferrerResultValue 表示查询的成功结果，包含 InstallReferrer 字符串和 InstallTimeEpochSeconds。

枚举

类型 名称 说明
Enum InstallReferrerError 表示安装引荐来源操作结果的状态代码，例如 Ok 和 Error。

命名空间：PlayPcSdkManaged.Recall

提供对 Play Games Services Recall API 的访问权限，该 API 可让您将游戏内账号与 Google Play Games Services 账号相关联。

类

客户端和结果

类型 名称 说明
Class RecallClient 用于与 Recall 服务互动的主要客户端。管理原生 C++ 连接，必须进行处置。
Class RequestRecallAccessResult RequestRecallAccessAsync 返回的结果。成功时包含 Recall 会话 ID。

结构体

模型

类型 名称 说明
Struct RequestRecallAccessResultValue 表示访问请求的成功结果，包含 RecallSessionId。

枚举

类型 名称 说明
Enum GamesRecallError 表示 Recall 操作结果的状态代码，例如 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。