开发 能力接入指南 8分屏能力接入指南
# 8分屏能力接入指南
更新时间:2024-08-30 11:31:44
# 8分屏能力简介
基于行业现状和部分场景需求,我们在直播和短视频场景提供了8分屏打开小程序的能力。开通此能力后,用户无需离开原有页面即可浏览小程序内容。
如下图直播场景,8分屏为用户提供边看直播边逛边买的体验,无需再进入中间页进行跳转,有效地优化了用户体验,提升转化效率。

# 接入流程
接入8分屏按以下步骤进行接入:
1、场景评估:不是所有业务/行业的小程序都适合使用8分屏。开发者可先评估需求场景,明确是否适合使用小程序的8分屏能力。
2、小程序管理后台内申请开通短视频 (opens new window)/直播挂载 (opens new window)能力。

3、在短视频挂载/直播挂载页面,打开8分屏开关。(无须审核)

4、打开8分屏开关后,可在小程序开发者工具中对8分屏进行调试。模拟器暂时不支持 8分屏调试,开发者工具需升级到1.22.0及其以上版本。
5、开发者需要针对8分屏做组件和api的适配(详见下方组件及API适配一览),完成后进行版本审核。未做适配的小程序提交版本审核后会被审核驳回。
6、版本审核通过后生效,线上可能存在分钟级的延迟。
# 样式规范
为保证用户使用八分屏能力的统一体验,请遵循以下标题样式:
标题样式规范:17号字,居中,高度56。

# 组件及API适配一览
基于8分屏小程序使用场景的特点,部分api/组件能力在8分屏场景下存在兼容问题(不影响非8分屏模式使用),请各位开发者参考列表做重点适配:
- 【不可用】:表示8分屏下禁止使用的能力,调用会报错
- 【可用】:表示关注适配即可
| 大类 | 一级类别 | 二级类别 | 是否可用 | 说明 | 相关API |
| 组件能力 | 基础组件 | icon | 是 | / | / |
| page-meta | 是 | / | / | ||
| progress | 是 | / | / | ||
| rich-text | 是 | / | / | ||
| text | 是 | / | / | ||
| 表单组件地图 | button | 是 | / | / | |
| checkbox-group | 是 | / | / | ||
| checkbox | 是 | / | / | ||
| form | 是 | / | / | ||
| input | 是 | / | / | ||
| label | 是 | / | / | ||
| picker-view-column | 是 | / | / | ||
| picker-view | 是 | / | / | ||
| picker | 是 | / | / | ||
| radio-group | 是 | / | / | ||
| radio | 是 | / | / | ||
| slider | 否 | 禁止 | / | ||
| switch | 是 | / | / | ||
| textarea | 是 | 需要关注兼容问题 | / | ||
| map | 否 | 禁止 | / | ||
| 媒体 | camera | 否 | 禁止 | ||
| image | 是 | / | / | ||
| video | 是 | / | / | ||
| 开放能力 | ad | 否 | 禁止 | / | |
| payment-list | 是 | / | / | ||
| slider | 否 | 禁止 | / | ||
| 导航组件 | navigator | 否 | 小程序互跳禁止 | / | |
| navigation-bar | 否 | 小程序互跳禁止 | / | ||
| 视图组件 | cover-image | 是 | / | / | |
| cover-view | 是 | / | / | ||
| movable-area | 否 | 禁止 | / | ||
| movable-view | 否 | 禁止 | / | ||
| scroll-view | 是 | / | / | ||
| swiper-item | 是 | / | / | ||
| swiper | 是 | / | / | ||
| view | 是 | / | / | ||
| api | 广告 | 广告 | 否 | 禁止 | createRewardedVideoAd |
| 基础 | 基础api | 是 | / | / | |
| 生命周期 | 是 | / | / | ||
| performance | 是 | 禁止 | / | ||
| 路由 | 是 | / | / | ||
| 系统 | 是 | / | / | ||
| 更新 | 否 | 禁止强制更新 | getUpdateManager UpdateManager.applyUpdate | ||
| 设备 | 加速度计 | 是 | / | / | |
| 电量 | 是 | / | / | ||
| 剪贴板 | 是 | / | / | ||
| 罗盘 | 是 | / | / | ||
| 设备方向 | 是 | / | / | ||
| 陀螺仪 | 是 | / | / | ||
| 内存 | 是 | / | / | ||
| 网络 | 是 | / | / | ||
| 电话 | 是 | / | makePhoneCall | ||
| 扫码 | 否 | 禁止扫码 | scanCode | ||
| 屏幕 | 是 | / | / | ||
| 振动 | 是 | / | / | ||
| wifi | 是 | / | / | ||
| 第三方平台 | 第三方平台 | 是 | / | / | |
| 文件 | 文件 | 是 | / | / | |
| KSML | KSML | 是 | / | / | |
| 位置 | 位置 | 是 | / | / | |
| 多媒体 | 音频 | 否 | 禁止 | createInnerAudioContext setInnerAudioOption onAudioInterruptionBegin offAudioInterruptionBegin onAudioInterruptionEnd offAudioInterruptionEnd | |
| 背景音频 | 否 | 禁止 | getBackgroundAudioManager | ||
| 相机 | 否 | 禁止 | createCameraContext | ||
| 图片 | 是 | / | / | ||
| 视频 | 否 | 禁止 | createVideoContext chooseVideo saveVideoToPhotosAlbum | ||
| 网络 | 网络 | 是 | / | / | |
| 开放接口 | 账户信息 | 是 | / | / | |
| 授权 | 是 | / | / | ||
| 登录 | 是 | / | / | ||
| 小程序跳转 | 否 | 禁止跳转 | navigateToMiniProgramnavigateBackMiniProgram | ||
| 支付 | 是 | / | / | ||
| 设置 | 是 | / | / | ||
| 订阅消息 | 是 | / | / | ||
| 用户信息 | 是 | / | / | ||
| 转发 | 转发 | 是 | / | / | |
| 数据缓存 | 数据缓存 | 是 | / | / | |
| 界面 | 背景 | 是 | / | / | |
| 交互 | 是 | / | / | ||
| 键盘 | 是 | / | getSelectedTextRange hideKeyboard onKeyboardHeightChange | ||
| 菜单 | 是 | / | / | ||
| 导航栏 | 是 | / | / | ||
| 下拉刷新 | 否 | 禁止下拉刷新 | startPullDownRefreshstopPullDownRefresh | ||
| 滚动 | 是 | / | / | ||
| tabbar | 否 | 禁止 | show/hideshowTabBarhideTabBar | ||
| 窗口 | 是 | / | / | ||
| 地图 | 地图 | 否 | 禁止 | createMapContext | |
| 环境变量 | 环境变量 | 是 | / | / | |
| 其他 | 其他客户端能力 | 分享 | 是 | / | / |
| 发快手 | 否 | 能力禁止 | / | ||
| 设为常用 | 是 | / | / | ||
| 收藏本页 | 是 | / | / | ||
| 添加桌面 | 是 | / | / | ||
| 设置 | 是 | / | / | ||
| 反馈 | 是 | / | / | ||
| 关于 | 是 | / | / | ||
| PLC挂载 | 否 | 禁止 | / | ||
| 直播间挂载 | 否 | 禁止 | / |
上一篇:《小程序关注服务号》
下一篇:《内容安全审核能力》
仍有疑问? 前往社区提问