SDK初始化

更新时间:2026-06-06 12:00:00OSDK

下载 SDK 并引用

点击下载 SDK

初始化

1.cocos引擎下需要先将下载的index.min.js文件导入为插件,原生js小游戏则忽略本步骤。

descript

2.引入 SDK 后,需要创建一个 sdk 实例(请在小游戏启动后的第一时间初始化sdk,以尽可能保证事件上报齐全),传入应用的配置信息。当用户登录后,可以调用sdk.setConfig() 方法设置用户信息,随后调用 sdk.trackEvent() 进行事件上报。

import OSDK from './path/to/osdk/index.min.js';

// 初始化SDK
const sdk = new OSDK({
  appid: 'your-app-id', // 必填,小游戏appid
  secret_key: 'your-secret-key', // 必填,找「苏」获取 secret_key
  debug: true, // 开启调试模式,开启后控制台会打印相关调试信息
  enableTrackTime: true, // 
});

初始化参数:

参数

类型

必填

描述

示例值

appid

string

是

小游戏appid

'wx123xxxxx'

secret_key

string

是

O2 开放平台分配给应用的 加密密钥,用于上报合法校验

'xxxxxx'

debug

boolean

否

是否开启调试模式,默认为false

true

enableTrackTime

boolean

否

是否允许统计时长,默认为true,打开时,SDK将在onShow,onHide事件触发时上报game_show/game_hide,同时1分钟上报一次心跳game_tick

true

相关文档