# 8分屏能力接入指南

更新时间:2024-08-30 11:31:44

# 8分屏能力简介

基于行业现状和部分场景需求,我们在直播和短视频场景提供了8分屏打开小程序的能力。开通此能力后,用户无需离开原有页面即可浏览小程序内容。

如下图直播场景,8分屏为用户提供边看直播边逛边买的体验,无需再进入中间页进行跳转,有效地优化了用户体验,提升转化效率。

img

# 接入流程

接入8分屏按以下步骤进行接入:

1、场景评估:不是所有业务/行业的小程序都适合使用8分屏。开发者可先评估需求场景,明确是否适合使用小程序的8分屏能力。

2、小程序管理后台内申请开通短视频 (opens new window)/直播挂载 (opens new window)能力。

img

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

img

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是//
第三方平台第三方平台是//
文件文件是//
KSMLKSML是//
位置位置是//
多媒体音频否禁止createInnerAudioContext
setInnerAudioOption
onAudioInterruptionBegin
offAudioInterruptionBegin
onAudioInterruptionEnd
offAudioInterruptionEnd
背景音频否禁止getBackgroundAudioManager
相机否禁止createCameraContext
图片是//
视频否禁止createVideoContext
chooseVideo
saveVideoToPhotosAlbum
网络网络是//
开放接口账户信息是//
授权是//
登录是//
小程序跳转否禁止跳转navigateToMiniProgramnavigateBackMiniProgram
支付是//
设置是//
订阅消息是//
用户信息是//
转发转发是//
数据缓存数据缓存是//
界面背景是//
交互是//
键盘是/getSelectedTextRange
hideKeyboard
onKeyboardHeightChange
菜单是//
导航栏是//
下拉刷新否禁止下拉刷新startPullDownRefreshstopPullDownRefresh
滚动是//
tabbar否禁止show/hideshowTabBarhideTabBar
窗口是//
地图地图否禁止createMapContext
环境变量环境变量是//
其他其他客户端能力分享是//
发快手否能力禁止/
设为常用是//
收藏本页是//
添加桌面是//
设置是//
反馈是//
关于是//
PLC挂载否禁止/
直播间挂载否禁止/
Copyright ©2026, All Rights Reserved