Midasbuy 游戏 SDK
1. SDK 描述
提供游戏菜单栏的展示和隐藏功能,并允许开发者自定义错误处理。
2. 集成 SDK
在 HTML 文件中引入脚本:
<script src="https://cdn.midasbuy.com/js/game.stable.js"></script>
3. API 文档
3.1. midas.game(params)
初始化游戏 SDK:
const gameApi = midas.game({
appid: '1460000xxx',
language: 'en',
region: 'us',
sandbox: 1,
});
参数 | 是否必填 | 位置 | 类型 | 格式 | 说明 |
---|---|---|---|---|---|
appid | Yes | params | String | string.min_len: 1 | 应用 ID |
language | Yes | params | String | string.len: 2 | 语言代码,目前 midasbuy 支持 ar,hk,tr,de,id,pu,tw,en,ja,ru,vn,es,ko,fr,my,th |
region | Yes | params | String | string.len: 2 | 国家代码,目前 midasbuy 开放站点列表参考 region select |
sandbox | No | params | Number | 0 现网,1 沙箱。默认为 0,联调时使用 1 |
3.2. gameApi.show(options)
展示游戏菜单栏:
gameApi.show({
gradually: true
})
.then((res) => {
console.log(res); // { res: 'show_menu_success' }
})
.catch((res) => {
console.log(res); // { res: 'show_menu_fail' }
});
参数 | 是否必填 | 位置 | 类型 | 格式 | 说明 |
---|---|---|---|---|---|
gradually | No | params | Boolean | 菜单的展示是否带过渡动画,默认为 true |
3.3. gameApi.hide()
隐藏游戏菜单栏:
gameApi.hide();
3.4. 错误处理
gameApi.setErrorHandler(handler: (error: Error) => void)
自定义错误处理:
gameApi.setErrorHandler((error) => {
console.error("Custom error handler:", error);
});
handler
: 自定义错误处理函数,默认为console.error
。
4. 调用示例
const gameApi = midas.game({
appid: '1460000xxx',
language: 'en',
region: 'us',
sandbox: 1,
});
gameApi.show({
gradually: true
})
.then((res) => {
console.log(res); // { res: 'show_menu_success' }
})
.catch((res) => {
console.log(res); // { res: 'show_menu_fail' }
});
gameApi.hide();
gameApi.setErrorHandler((error) => {
console.error("Custom error handler:", error);
});
Demo 页面链接:Midasbuy 游戏 SDK Demo