# 实例属性及方法

注意事项

使用 new DHMiniSDK(options) 进行SDK初始化时,将返回一个实例对象,本文档暂且将该实例命名为 sdkInstance,后续章节内容及示例代码均基于此命名进行说明或演示,谢谢!

# 实例属性

SDK实例属性如下表所示:

属性 类型 说明
version string SDK的版本号,如 2.0.0
system object 系统信息,详情请参考 qg.getSystemInfoSync() 接口文档
    system.platform string 客户端设备类型
networkType string 网络类型,详情请参考 qg.getNetworkType() 接口文档
deviceId string 设备唯一标识(注意,因SDK无法获取真实的设备唯一标识,故使用一个32位随机字符串作为设备唯一标识,并存储于客户端缓存中;后续进入小游戏,若有缓存则从缓存中获取,无缓存则重新生成并存入缓存;因此无法确保设备唯一标识的准确性)
launchOptions object 游戏的启动参数,详情请参考 qg.getLaunchOptionsSync() 接口文档
gameAppId string 游戏在小米开放平台侧的 AppID
appId string 游戏在SDK开放平台侧的 AppID
appVersion string 游戏的版本号,如 2.0.4.10
packageName string 游戏的应用包名,如 com.dianhun.abc
channel number 游戏渠道包ID,如 3442
mainChannel number 推广主渠道ID,如 100786
secondChannel number 推广次渠道ID,如 100787
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 用户在小米侧的唯一标识(appAccountId)
        userInfo.userExtraInfo.session string 用户在小米侧的登录会话ID(session)
        userInfo.userExtraInfo.userName string 用户在小米侧的账号名称
        userInfo.userExtraInfo.avatar string 用户在小米侧的头像
        userInfo.userExtraInfo.nickName string 用户在小米侧的昵称

# 实例方法

SDK实例方法如下表所示:

方法 类型 说明
login function 用于执行登录并获取SDK开放平台用户信息,详情请查看本文档后续章节
getUserInfo function 用于获取小米用户信息,详情请查看本文档后续章节
pay function 用于发起支付流程,详情请查看本文档后续章节
createRewardedVideoAd function 用于创建激励视频广告,详情请查看本文档后续章节
analytics object 数据/日志上报
    analytics.loaded function 上报游戏启动事件,详情请查看本文档后续章节
    analytics.register function 上报用户注册事件,详情请查看本文档后续章节
    analytics.logged function 上报用户登录事件,详情请查看本文档后续章节
    analytics.uploadRoleInfo function 上报用户角色信息更新事件,详情请查看本文档后续章节
    analytics.pay function 上报用户充值事件,详情请查看本文档后续章节
    analytics.ad function 上报用户广告行为事件,如:播放广告、广告内点击、关闭广告、广告错误事件等,详情请查看本文档后续章节
    analytics.share function 上报用户分享行为事件,详情请查看本文档后续章节
    analytics.log function 上报用户的操作行为日志,方便快速定位问题的根源、追踪程序执行的过程、数据的变化等,详情请查看本文档后续章节
    analytics.event function 上报其它自定义事件,详情请查看本文档后续章节
Last Updated: 2024/9/10 10:06:37