# 实例属性及方法
注意事项
使用 new DHMiniSDK(options) 进行SDK初始化时,将返回一个实例对象,本文档暂且将该实例命名为 sdkInstance,后续章节内容及示例代码均基于此命名进行说明或演示,谢谢!
# 实例属性
SDK实例属性如下表所示:
| 属性 | 类型 | 说明 |
|---|---|---|
| version | string | SDK的版本号,如 2.0.0 |
| system | object | 系统信息,详情请参考 my.getSystemInfoSync() 接口文档 |
| system.platform | string | 客户端设备类型
|
| networkType | string | 网络类型,详情请参考 my.getNetworkType() 接口文档 |
| deviceId | string | 设备唯一标识(注意,因SDK无法获取真实的设备唯一标识,故使用一个32位随机字符串作为设备唯一标识,并存储于客户端缓存中;后续进入小游戏,若有缓存则从缓存中获取,无缓存则重新生成并存入缓存;因此无法确保设备唯一标识的准确性) |
| launchOptions | object | 淘宝小游戏暂不支持获取小游戏的启动参数 |
| gameAppId | string | 游戏在淘宝侧的 AppID |
| cloud | object | 淘宝云应用SDK |
| cloudAppId | number | 游戏在淘宝侧创建的空应用的 cloudAppId |
| appId | string | 游戏在SDK开放平台侧的 AppID |
| appVersion | string | 游戏的版本号,如 2.0.4.10 |
| packageName | string | 游戏的应用包名,如 com.dianhun.abc |
| channel | number | 游戏渠道包ID,如 3466 |
| mainChannel | number | 推广主渠道ID,如 100907 |
| secondChannel | number | 推广次渠道ID,如 100908 |
| userInfo | object | 用户信息(用户于SDK开放平台侧的登录信息),仅在登录成功后可用 |
| userInfo.accountId | number | 账号ID |
| userInfo.accountName | string | 账号名称 |
| userInfo.accountView | string | 账号缩略 |
| userInfo.expireTimestamp | number | 登录态过期时间,秒级时间戳 |
| userInfo.loginTimestamp | number | 登录时间,秒级时间戳 |
| userInfo.loginType | number | 登录类型 |
| userInfo.region | number | 所属地区,1 表示中国大陆,0 表示港澳台及海外 |
| userInfo.sign | string | 签名(本地验签使用) |
| userInfo.token | string | 登录token |
| userInfo.userExtraInfo | object | 用户扩展信息(用户于第三方渠道侧的登录信息) |
| userInfo.userExtraInfo.openId | string | 用户在淘宝侧的唯一标识(openId) |
| userInfo.userExtraInfo.userName | string | 用户在淘宝侧的账号名称 |
| userInfo.userExtraInfo.avatar | string | 用户在淘宝侧的头像 |
| userInfo.userExtraInfo.nickName | string | 用户在淘宝侧的昵称 |
# 实例方法
SDK实例方法如下表所示:
| 方法 | 类型 | 说明 |
|---|---|---|
| login | function | 用于执行登录并获取SDK开放平台用户信息,详情请查看本文档后续章节 |
| uploadRoleInfo | function | 用于在用户登录游戏服成功、创角成功、角色升级时上报相关角色信息,详情请查看本文档后续章节 |
| getUserInfo | function | 用于获取淘宝用户信息,详情请查看本文档后续章节 |
| pay | function | 用于发起支付流程,详情请查看本文档后续章节 |
| createRewardedVideoAd | function | 用于创建激励视频广告,详情请查看本文档后续章节 |
| openCustomerServiceConversation | function | 用于打开客服会话,详情请查看该文档后续章节 |
| share | function | 用于主动拉起淘宝分享组件进行分享,详情请查看该文档后续章节 |
| getShareInfo | function | 用于被分享者获取分享信息,详情请查看该文档后续章节 |
| openSetting | function | 用于打开设置界面,返回用户设置的操作结果 |
| getSetting | function | 用于获取用户的当前设置 |
| getAccountId | function | 用于获取用户的账号ID,未登录状态下返回值为空 |
| getOpenId | function | 用于获取用户的微信openId,未登录状态下返回值为空 |
| trackEvent | function | 用于上报并记录用户在游戏内的行为日志&事件,详情请查看本文档后续章节 |