小程序名称—微信小程序直播
[db:短标题]
一、 详细介绍
手机微信微信小程序直播间间是手机上手机微信官方网网提供的商家经营专用型专用工具。依据开启这类状况件，商家可以在手机微信微信小程序中进行直播间间互动交流沟通交流与商品销售市场市场销售闭环控制操纵。
[标识:內容1]
按照下面的运用说明联接，在你的手机微信微信小程序中引入直播间间构件便可以进行直播间间功效。运用整个过程中如遇到难点，可在手机微信微信小程序直播间间住宅小区发帖子子沟通交流沟通交流。
二、 运用方法说明1. 【直播间间构件】如何引入版本号号限制：手机上手机微信消费者端版本号号 7.0.7 及以上（基本库版本号号2.9.x及以上可用同层三d3D渲染）可以收手机看直播间及运用直播间间间的功效，低版本号号刚进入直播间间间情况下提示顾客升级手机上手机微信消费者端版本号号（低版本号号仅有收手机看直播间，无法运用直播间间间的功效）。
可用在主包或分包内引入【直播间间构件】 live-player-plugin 编号包（注：直播间间构件不计入入入编号宽容积），最新项目网站网站根目录的 app.json 引进，案例编号下列：1. 主包引入 plugins : {
live-player-plugin : {
version : 1.0.9 , // 注意填好该直播间间构件全新升级版本号号号，手机上手机微信开发设计设计方案者专用型专用工具调整时可得到全新升级版本号号号（复制时请祛除注释）
provider : wx2b03c6e691cd7370 // 尽量填该直播间间构件appid，该案例值就是直播间间构件appid（复制时请祛除注释）
}
}2. 分包引入 subpackages : [
{
plugins : {
live-player-plugin : {
version : 1.0.9 , // 注意该直播间间构件全新升级版本号号号，手机上手机微信开发设计设计方案者专用型专用工具调整时可得到全新升级版本号号号（复制时请祛除注释）
provider : wx2b03c6e691cd7370 // 尽量填该直播间间构件appid，该案例值就是直播间间构件appid（复制时请祛除注释）
}
}
}
]2. 【直播间间构件】如何运用按第一步的方法把构件编号包配置引入后，便可以马上依据联接详尽详细地址全自动自动跳转到直播间间构件网页页面网页页面（就是进直播间间间网页页面网页页面）联接详尽详细地址务必带上直播间间房间 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’）。
案例具体实际效果图下列：三、 其他相关构件、插孔和携带关键主要参数订阅构件： subscribe
得到直播间间状况API： getLiveStatus
得到顾客openid关键主要参数API： getOpenid
得到共享资源卡牌联接关键主要参数API： getShareParams
直播间间间到商详网页页面网页页面携带关键主要参数：room_id + openid + share_openid + custom_params
从群共享资源卡牌返回直播间间间时携带关键主要参数： shareTicket
直播间间小窗控制关键主要参数： close_picture_in_picture_mode
后台管理管理方法得到直播间间房间文件目录 API
后台管理管理方法得到回放源视频 API
注：以上 2 个后台管理管理方法开启的插孔总限定 10 万次数数/天，200 次/分鐘1. 【订阅】构件（注：若要运用这类状况件，需在主包引入直播间间构件）功效描述：顾客进入直播间间间内，可对一场未开播的直播间间进行一次订阅，开播时直播间间构件会自动式下达开播提醒给顾客，无需开发设计设计方案者额外开发设计设计方案
构件运用：倘若务必在直播间间构件页以外手机微信微信小程序其他网页页面网页页面也是有一样的开播提醒的功效，可以引入【订阅】构件 subscribe（开播前才会显示信息信息内容，直播间间一开始后自动式消散这类状况件）；需在 page 网页页面网页页面（如 home 网页页面网页页面）的 home.json 引进订阅构件。
案例编号下列： {
usingComponents : {
subscribe : plugin-private://wx2b03c6e691cd7370/components/subscribe/subscribe
}
}接着就可以在 home.wxml 里运用订阅构件，在这其中直播间间房间 id 可依据；房间 id 可依据下面【得到直播间间房间文件目录】 API 得到
subscribe room-id= [直播间间房间id] /subscribe2. 【得到直播间间状况】插孔（注：若要运用该插孔，需在主包引入直播间间构件）
插孔说明：第一次得到马上返回直播间间状况，往后面面间隔一分鐘或更慢的頻率去轮询得到直播间间状况
直播间间状况说明：101 直播间间中：说明互联网网络主播一切一切正常开播，直播间间一切一切正常的状况
102 未一开始：说明互联网网络主播还未开播
103 已结束：说明在直播间间连接点击【结束】功能键一切一切正常关闭的直播间间，或直播间间出現出现异常 15 分鐘后系统软件手机软件强制性性结束的直播间间
104 禁播：说明因违背要求遭到运营处罚被和睦播
105 中断中：说明在 MP 手机微信微信小程序后台管理管理方法-控制台内具体实际操作中断了直播间间
106 出現出现异常：说明互联网网络主播离开、切后台管理管理方法、断掉联接等情况，该直播间间判刑纳入出現出现异常状况，15 分鐘内修补便可以回到一切一切正常直播间间中的状况；倘若 15 分鐘后还未修补，直播间间间会被系统软件手机软件强制性性结束直播间间
107 到期：说明直播间间间一直未开播，且已保证在 MP 手机微信微信小程序后台管理管理方法创建直播间间间时填好的直播间间计划方案结束时间，则该直播间间判刑纳入期满不能以再开播
开启方法：若要开启【得到直播间间状况】插孔 getLiveStatus，需在手机微信微信小程序网页页面网页页面顶部引进【直播间间构件】 live-player-plugin。
案例编号下列： let livePlayer = requirePlugin( live-player-plugin )
// 第一次得到马上返回直播间间状况
const roomId = xxx // 房间 id
livePlayer.getLiveStatus({ room_id: roomId })
.then(res = {
// 101: 直播间间中, 102: 未一开始, 103: 已结束, 104: 禁播, 105: 中断中, 106: 出現出现异常，107：到期
const liveStatus = res.liveStatus
console.log( get live status , liveStatus)
})
.catch(err = {
console.log( get live status , err)
})
// 往后面面间隔一分鐘或更慢的頻率去轮询得到直播间间状况
setInterval(() = {
livePlayer.getLiveStatus({ room_id: roomId })
.then(res = {
// 101: 直播间间中, 102: 未一开始, 103: 已结束, 104: 禁播, 105: 中断中, 106: 出現出现异常，107：到期
const liveStatus = res.liveStatus
console.log( get live status , liveStatus)
})
.catch(err = {
console.log( get live status , err)
})
}, 60000)3. 【得到顾客openid关键主要参数】插孔（注：若要运用该插孔，需在主包引入直播间间构件）插孔说明：在直播间间构件版本号号 1.0.9 及以上版本号号依据该插孔得到顾客openid关键主要参数。
开启方法：若要开启【得到顾客openid关键主要参数】插孔 getOpenid，需在手机微信微信小程序网页页面网页页面顶部引进【直播间间构件】 live-player-plugin。
案例编号下列： let livePlayer = requirePlugin( live-player-plugin )
App({
onShow(options) {
livePlayer.getOpenid({ room_id: [直播间间房间id] }) // 该插孔传入关键主要参数为房间号
.then(res = {
console.log( get openid , res.openid) // 顾客openid
}).catch(err = {
console.log( get openid , err)
})
}
})4. 【得到共享资源卡牌联接关键主要参数】插孔（注：若要运用该插孔，需在主包引入直播间间构件）插孔说明：由于基本库数据信息信息内容安全性性防范措施，依据App onShow 性命周期时间時间里的query无法得到直播间间间共享资源卡牌联接关键主要参数。在直播间间构件版本号号 1.0.9 及以上版本号号依据该插孔得到以下关键主要参数，开发设计设计方案者可以根据这类关键主要参数建立顾客、直播间间间、商品正中间的投影关系。
共享资源卡牌进入直播间间间：房间号 room_id + 进入者 openid + 共享资源者 share_openid + 开发设计设计方案者自定关键主要参数 custom_params开启方法：若要开启【得到共享资源卡牌联接关键主要参数】插孔 getShareParams，需在手机微信微信小程序网页页面网页页面顶部引进【直播间间构件】 live-player-plugin。
案例编号下列： let livePlayer = requirePlugin( live-player-plugin )
App({
onShow(options) {
// 共享资源卡牌安全通道场景才开启getShareParams插孔得到以下关键主要参数
if (options.scene == 1007 || options.scene == 1008 || options.scene == 1044) {
livePlayer.getShareParams()
.then(res = {
console.log( get room id , res.room_id) // 房间号
console.log( get openid , res.openid) // 顾客openid
console.log( get share openid , res.share_openid) // 共享资源者openid，共享资源卡牌进入场景才有
console.log( get custom params , res.custom_params) // 开发设计设计方案者在全自动自动跳转进入直播间间间网页页面网页页面时，网页页面网页页面相对性相对路径上携带的自定关键主要参数，这儿传入给开发设计设计方案者
}).catch(err = {
console.log( get share params , err)
})
}
}
})5. 携带关键主要参数版本号号限制：直播间间构件版本号号 1.0.9 及以上可用携带以下关键主要参数，开发设计设计方案者可以根据这类关键主要参数建立顾客、直播间间间、商品正中间的投影关系。
（1） shareTicket：共享资源直播间间间卡牌拿到机手机微信群，点一下此卡牌后可以在 App onShow 里得到该关键主要参数（默认设置设定可得到该关键主要参数，但长按共享资源卡牌时不能以共享。可在全自动自动跳转直播间间间网页页面网页页面相对性相对路径上配置close_share_ticket=1关闭shareTicket，如 plugin-private://wx2b03c6e691cd7370/pages/live-player-plugin?room_id=直播间间房间号 close_share_ticket=1 ，这时候长按共享资源卡牌时可以共享。）
（2） room_id + openid + share_openid + custom_params ：点一下直播间间间里的仓储物流仓储货架商品全自动自动跳转到商家手机微信微信小程序的商品详尽信息内容页或点一下直播间间间左上边首页icon全自动自动跳转到商家手机微信微信小程序的首页时，可以在Page onLoad options里得到房间号、顾客openid、共享资源者share_openid（倘若是以共享资源卡牌进入直播间间间再全自动自动跳转到商详页才有该关键主要参数）、开发设计设计方案者携带的自定关键主要参数custom_params
6. 直播间间小窗版本号号限制：直播间间构件版本号号 1.0.9 及以上可用依据以下关键主要参数设置不是是关闭小窗。
close_picture_in_picture_mode：默认设置设定可用直播间间小窗，可依据close_picture_in_picture_mode=1关闭小窗功效，如 plugin-private://wx2b03c6e691cd7370/pages/live-player-plugin?room_id=直播间间房间号 close_picture_in_picture_mode=1 。
7. 【得到直播间间房间文件目录】插孔，仅作后台管理管理方法开启插孔规范：该插孔仅作商家后台管理管理方法开启，开启信用额度 10 万次数数/天，200 次/分鐘，建议开发设计设计方案者本身做缓存文件文档（此插孔与下面【得到回放视频】插孔同用 10 万次数数/天限制，200 次/分鐘，请合理分配开启频次）。
乞求URL： api.weixin.qq/wxa/business/getliveinfo?access_token=
乞求方式： POST
乞求案例：Request {
start : 0, // 起始拉取房间，start = 0 说明从第 1 个房间一开始拉取
limit : 10 // 每一次拉取的总数限定，无须设置过大，建议 100 以内
}Response {
errcode : 0, // errcode = 0 寓意着获得取得成功；errcode = 1 寓意着未创建直播间间房间
errmsg : ok ,
room_info : [{
name : 直播间间房间名 ,
roomid : 1,
cover_img : http:\/\/mmbiz.qpic.cn\/mmbiz_jpg\/Rl1RuuhdstSfZa8EEljedAYcbtX3Ejpdl2et1tPAQ37bdicnxoVialDLCKKDcPBy8Iic5kCiaiaalXg3EbpNKoicrweQ\/0?wx_fmt=jpeg ,
share_img : http:\/\/mmbiz.qpic.cn\/mmbiz_jpg\/Rl1RuuhdstSfZa8EEljedAYcbtX3Ejpdl2et1tPAQ37bdicnxoVialDLCKKDcPBy8Iic5kCiaiaalXg3EbpNKoicrweQ\/0?wx_fmt=jpeg ,
live_status : 101,
start_time : 1568128900,
end_time : 1568131200,
anchor_name : 李四 ,
goods : [
{
cover_img : mmbiz.qpic.cn/mmbiz_png/FVribAGdErI2PmyST9ZM0JLbNM48I7TH2FlrwYOlnYqGaej8qKubG1EvK0QIkkwqvicrYTzVtjKmSZSeY5ianc3mw/0?wx_fmt=png ,
url : pages/index/index.html ,
price : 1100,
name : fdgfgf
}
]
}],
total : 1
}返回字段名名：name 房间名
roomid 房间 id
注：需先在手机微信微信小程序 MP 后台管理管理方法创建直播间间房间，要不然会错误（歪斜确码 1）cover_img 直播间间间状况墙
share_img 共享资源卡牌封面图图
start_time 直播间间计划方案一开始时间，文件目录按照 start_time 降序排列
end_time 直播间间计划方案结束时间
anchor_name 互联网网络主播名
goods 商品文件目录
live_status 直播间间状况 101: 直播间间中, 102: 未一开始, 103: 已结束, 104: 禁播, 105: 中断中, 106: 出現出现异常, 107: 到期（直播间间状况描述可参考【得到直播间间状况】插孔）
8. 【得到回放源视频】插孔，仅作后台管理管理方法开启插孔规范：该插孔仅作商家后台管理管理方法开启，开启信用额度 10 万次数数/天，200 次/分鐘，此插孔与上面【得到房间文件目录】插孔同用 10 万次数数/天限制，200 次/分鐘，请合理分配开启频次）。
插孔说明：该插孔可在直播间间结束后获得回放源视频（直播间间结束后大约 10 分鐘会转换成回放，源视频无点评等内容）
获得源视频后务必开发设计设计方案者独立开发设计设计方案、运用回放视频
倘若把源视频马上放进手机微信微信小程序上运用，务必手机微信微信小程序具备视频资质证书资格证书（具体资质证书资格证书要求请参考《手机微信微信小程序开发设计设计方案的类目服务》）
官方网网已提供了回放功效（直播间间构件版本号号1.0.9及以上版本号号）无需开发设计设计方案，官方网网提供的回放视频有效期是一年，如需长期性性保持可用上面插孔得到完全免费免费下载存储。
乞求URL： api.weixin.qq/wxa/business/getliveinfo?access_token=
乞求方式： POST
乞求案例：Request {
action : get_replay , // 得到回放
room_id : 354, // 直播间间间 id
start : 0, // 起始拉取视频，start = 0 说明从第 1 个视频片段一开始拉取
limit : 10 // 每一次拉取的总数限定，无须设置过大，建议 100 以内
}Response {
live_replay : [
{
expire_time : T03:49:55Z , // 回放视频 url 期满时间
create_time : T03:49:55Z , // 回放视频创建时间
media_url : xxxxx.vod2.myqcloud/xxxxx/xxxxx/f0.mp4 // 回放视频
}
],
errcode : 0,
total : 1,
errmsg : ok
} // 一场直播间间可能会导致很多视频片段。9. 【创建直播间间间】插孔，仅作后台管理管理方法开启插孔规范：该插孔仅作商家后台管理管理方法开启，开启信用额度 1 万次数数/天。
插孔说明：该插孔可马上创建直播间间间，创建获得取得成功后直播间间间将在直播间间间文件目录呈现乞求URL： api.weixin.qq/wxaapi/broadcast/room/create?access_token=
乞求方式： POST
乞求案例：Request {
name : 检验直播间间间 //房间名字
coverImg : xxxxxx //填好mediaID，直播间间间状况图，相片规范：建议清楚度800*640，规格不超过1M，mediaID得到参考：developers.weixin.qq/doc/offiaccount/Asset_Management/New_temporary_materials.html）
startTime : 1588237130 // 直播间间计划方案一开始时间，1.开播时间需在现如今时间10Min后，2.一开始时间不能以在6个月后
endTime : 1588237130 //直播间间计划方案结束时间，1.开播时间和结束时间间隔不能短于30Min，不能超过二十四钟头
anchorName : test1 // 互联网网络主播呢称
anchorWechat : test1 //互联网网络主播手机上手机微信号，需依据实名认证验证认证，要不然将错误
anchorImg : xxx //填好mediaID，直播间间间共享资源图，相片规范：建议清楚度1080*1920，规格不超过2M，mediaID得到参考：developers.weixin.qq/doc/offiaccount/Asset_Management/New_temporary_materials.html）
type :1 //直播间间类型，1：推流，0：手机上上直播间间
screenType :0 //1：全屏幕，0：坚屏，自动式根据实际视频鉴别率调整
closeLike :0 //1：关闭关心 0：开启关心 ，关闭后无法开启
closeGoods :0 //1：关闭仓储物流仓储货架 0：打开仓储物流仓储货架，关闭后无法开启
closeComment :0 //1：关闭点评 0：打开点评，关闭后无法开启
}Response {
roomId : 33, //房间ID
errcode : 0
}四、 其他说明1、 直播间间间手机微信微信小程序码说明：手机微信微信小程序引入直播间间构件后尽量进行一次手机微信微信小程序发布公布，要不然直播间间间的手机微信微信小程序码不久效，具体关键主要表现是顾客扫二维码进入直播间间间会显示信息信息内容“网页页面网页页面不容易有”。
在 MP 手机微信微信小程序直播间间后台管理管理方法创建好直播间间间后，可以马上获得直播间间间共享资源手机微信微信小程序码，无需额外开发设计设计方案
倘若商家在后台管理管理方法本身转换成的直播间间间手机微信微信小程序码，务必做以下配置： 在全自动自动跳转进入直播间间间的相对性相对路径加上 type = 9 标示场景安全通道为手机微信微信小程序码： plugin-private://wx2b03c6e691cd7370/pages/live-player-plugin?room_id=[直播间间房间id] type=9 。 如要要带上自定关键主要参数则还务必加上 custom_params： plugin-private://wx2b03c6e691cd7370/pages/live-player-plugin?room_id=[直播间间房间id] type=9 custom_params=encodeURIComponent(JSON.stringify(custom_params)) 。
2、 商家手机微信微信公众号文章内容內容再加手机微信微信小程序卡牌说明：商家在手机微信微信公众号文章内容內容里加上全自动自动跳转进入直播间间间的手机微信微信小程序卡牌时，务必做以下配置： 在全自动自动跳转进入直播间间间的相对性相对路径加上 type = 10 标示场景安全通道为手机微信微信小程序卡牌： plugin-private://wx2b03c6e691cd7370/pages/live-player-plugin?room_id=[直播间间房间id] type=10 。 如要要带上自定关键主要参数则还务必加上 custom_params： plugin-private://wx2b03c6e691cd7370/pages/live-player-plugin?room_id=[直播间间房间id] type=10 custom_params=encodeURIComponent(JSON.stringify(custom_params)) 。
3、 商品详尽信息内容页注意事项（1）再加返回功能键: 点一下直播间间构件网页页面网页页面里的仓储物流仓储货架商品全自动自动跳转到商家手机微信微信小程序的商品详尽信息内容网页页面网页页面后，便于避免顾客无法再返回直播间间间，商家需在手机微信微信小程序商品详尽信息内容网页页面网页页面左上边加上返回功能键，依据wx.navigateBack返回到直播间间构件网页页面网页页面。（2）不建议运用wx.switchTab：若在商品详尽信息内容页点一下功能键（如购物车功能键等）依据wx.switchTab全自动自动跳转到tabbar页，接着点一下小窗回到直播间间间情况下出现网页页面网页页面卡死难点（手机上手机微信消费者端7.0.15版本号号才修复）。这时候可把网页页面网页页面改为非tabbar页并依据wx.navigateTo全自动自动跳转，也可依据关闭小窗来解决该难点。 （3）不建议运用wx.reLaunch：若在商品详尽信息内容页及之后的网页页面网页页面原素上运用wx.reLaunch全自动自动跳转，不仅会关闭小窗，而且无法返回到上一页，体会不大好。
4、 快速升級直播间间构件版本号号的方法商家手机微信微信小程序相符合的管理方法方式员手机上手机微信号收到【手机微信微信公众号安全性性小小助手】下达的直播间间构件版本号号升級的服务通知后，可点一下通知进行快速发布，手机上端便可以快速升級手机微信微信小程序内直播间间构件的新版本本本，无需修改编号或再度提交审核。
服务通知下列图所显示信息：五、 版本号号升級系统软件系统日志1.0.0提升直播间间小窗具体实际效果共享资源安全通道外现直播间间间直播间间结束页商品呈现提高抽奖活动主题活动详尽详细地址提高1.0.1减缩编号宽容积至 445 KB全自动自动跳转至商品详尽信息内容页时带上 room_id 关键主要参数共享资源时带上 shareTicket 关键主要参数给商家得到直播间间状况插孔提高1.0.2携带 openid / room_id / 自定关键主要参数给开发设计设计方案者提高全自动自动跳转至商详页再跳回直播间间间先load封面图图难点修复 windows 综合服务平台无法收手机看直播间难点修复企业手机上手机微信提示升级难点1.0.3提升推流功效得到共享资源联接关键主要参数getShareParams插孔提高1.0.4提升回放功效依据close_share_ticket关键主要参数设置shareTicket商品联接可用全自动自动跳转到tab网页页面网页页面1.0.5提高一一部分型号规格回放拉申等难点修复直播间间小窗重音难点修复消费者端导致关心日本动漫显示信息信息内容难点修复全自动自动跳转其他网页页面网页页面提示“现如今处于非WiFi当然自然环境，一定要留意流量消耗”难点1.0.6提升小小的小助手功效1.0.8提升坚屏清屏功效提升回放视频小窗功效提高点评地域卡屏难点修复商品联接type关键主要参数被遮住难点修复商品联接关键主要参数里的html被祛除难点1.0.9修复进直播间间间闪过仓储物流仓储货架难点1.0.10修复全屏幕下点一下清屏再返回坚屏后互动交流沟通交流功能键失效难点修复从左往右划时出现清屏日本动漫难点1.0.11修复弹起点评框后点直播间间页面地域无法收缩难点修复清屏回家了打开仓储物流仓储货架无法收缩难点扫描二维码分享到微信