# 小程序直播

小程序直播是微信官方提供的商家经营工具。通过调用该组件，商家可以在小程序中实现直播互动与商品销售闭环。

按照下面的使用说明接入，在你的小程序中引入直播组件即可实现直播功能。使用过程中如遇到问题，可在小程序直播社区发帖交流。

# 一、使用方法说明

# 1.1 直播组件如何引入

版本限制：微信客户端版本 7.0.7 及以上（基础库版本2.9.x及以上支持同层渲染）可以观看直播及使用直播间的功能，低版本刚进入直播间时会提示用户升级微信客户端版本（低版本只能观看直播，无法使用直播间的功能）。

支持在主包或分包内引入【直播组件】 live-player-plugin 代码包（注：直播组件不计入代码包体积），项目根目录的 app.json 引用，示例代码如下：

1. 主包引入

   "plugins": {
       "live-player-plugin": {
           "version": "1.3.0", // 注意填写该直播组件最新版本号，微信开发者工具调试时可获取最新版本号（复制时请去掉注释）
           "provider": "wx2b03c6e691cd7370" // 必须填该直播组件appid，该示例值即为直播组件appid（复制时请去掉注释）
       }
   }
   

2. 分包引入

   "subpackages": [
       {
           "plugins": {
               "live-player-plugin": {
                   "version": "1.3.0", // 注意该直播组件最新版本号，微信开发者工具调试时可获取最新版本号（复制时请去掉注释）
                   "provider": "wx2b03c6e691cd7370" // 必须填该直播组件appid，该示例值即为直播组件appid（复制时请去掉注释）
               }
           }
       }
   ]
   

# 1.2 直播组件如何使用

按第1步的方法把组件代码包配置引入后，即可直接通过链接地址跳转到直播组件页面（即为进直播间页面）链接地址需要带上直播房间 id；房间 id 可通过下面 获取直播房间列表 API 获取。

# 示例代码如下：

1. 使用 navigator 组件跳转进入直播间

   index.js

   let roomId = [直播房间id] // 填写具体的房间号，可通过下面【获取直播房间列表】 API 获取
   let customParams = encodeURIComponent(JSON.stringify({ path: 'pages/index/index', pid: 1 })) // 开发者在直播间页面路径上携带自定义参数（如示例中的path和pid参数），后续可以在分享卡片链接和跳转至商详页时获取，详见【获取自定义参数】、【直播间到商详页面携带参数】章节（上限600个字符，超过部分会被截断）
   this.setData({
       roomId,
       customParams
   })
   

   index.wxml

   <navigator url="plugin-private://wx2b03c6e691cd7370/pages/live-player-plugin?room_id={{roomId}}&custom_params={{customParams}}"></navigator>
   <!--其中wx2b03c6e691cd7370是直播组件appid不能修改-->
   

2. 使用 navigateTo 方法跳转进入直播间

   index.js

   let roomId = [直播房间id] // 填写具体的房间号，可通过下面【获取直播房间列表】 API 获取
   let customParams = encodeURIComponent(JSON.stringify({ path: 'pages/index/index', pid: 1 })) // 开发者在直播间页面路径上携带自定义参数（如示例中的path和pid参数），后续可以在分享卡片链接和跳转至商详页时获取，详见【获取自定义参数】、【直播间到商详页面携带参数】章节（上限600个字符，超过部分会被截断）
   wx.navigateTo({
       url: `plugin-private://wx2b03c6e691cd7370/pages/live-player-plugin?room_id=${roomId}&custom_params=${customParams}`
   })
   // 其中wx2b03c6e691cd7370是直播组件appid不能修改
   

通过该链接可跳转到直播组件页面（当前页面入口仅开放 live-player-plugin）。

# 示例效果图如下：

# 二、直播组件和接口

# 2.1 组件接口

通过在主包/分包中引入直播组件，开发者可以很方便的实现订阅、获取直播状态、获取用户openid以及获取分享卡片链接参数等功能。

# 2.2 服务端接口

直播间管理接口，是小程序直播提供给开发者对直播房间进行批量操作的接口能力。开发者可以创建直播间、获取直播间信息、获取直播间回放以及往直播间导入商品。

商品管理接口是小程序直播提供给开发者对直播商品进行批量操作的接口能力。开发者可以对商品批量进行添加、提审、删除以及更新等操作。

接口仅支持对通过接口添加的商品进行操作，开发者在小程序管理后台添加的商品，不支持通过接口操作。

开发者必须保存【商品ID】与【审核单ID】，如果丢失，则无法调用其他相关接口。

直播成员管理接口，是小程序直播提供给开发者对直播成员进行批量管理的接口能力。

开发者可以通过接口设置、查询、移除直播成员的角色，不同角色拥有不同的管理权限，具体请查看小程序直播成员管理说明。

长期订阅接口