基础库 3.99.5 开始支持,低版本需做兼容处理
调用该API可以跳转到某个小游戏入口场景,目前仅支持跳转「侧边栏」场景。
侧边栏能力说明
参数
属性名 | 类型 | 默认值 | 必填 | 说明 |
scene | string | ‘sidebar’ | 否 | 需要确认的入口场景(目前仅支持的入参为'sidebar') |
success | Function | | 否 | 接口调用成功的回调函数 |
complete | Function | | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
fail | Function | | 否 | 接口调用失败的回调函数 |
回调成功
属性名 | 类型 | 说明 |
errMsg | string | 恒为'navigateToScene:ok' |
回调失败
属性名 | 类型 | 说明 |
errMsg | string | |
errCode | number | 错误码 |
错误码&错误信息
错误码 | 错误信息 | 说明 |
20001 | expect params.scene to be one of "sidebar", but got xxx | 参数校验错误:参数类型错误 |
20001 | expect params.scene to be one of "sidebar", but got xxx | 参数校验错误:参数拼写错误 |
21101 | scene xxx is inaccessible | xxx入口场景不可达 |
代码示例
bl.navigateToScene({
scene: "sidebar",
success: (res) => {
console.log("navigate to scene success");
// 跳转成功回调逻辑
},
fail: (res) => {
console.log("navigate to scene fail: ", res);
// 跳转失败回调逻辑
},
});