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.Unity

适用于 SDK 的 Unity 专用辅助程序和适配器。

类

类型	名称	说明
Class	PlayPcSdkFactory	用于创建 BillingClient 和 IntegrityClient 实例以及检索 InitializationHandler 的工厂类。此类用于处理特定于 Unity 的回调生成。

命名空间：PlayPcSdkManaged.Core

在 SDK 模块之间共享的核心基础架构。

类

类型	名称	说明
Class	Result<TError, TValue>	所有 API 结果的基类。提供属性 IsOk、Code、ErrorMessage 和 Value。