微信小程序 服务端接口-直播间接口


本文整理自网络,侵删。

【小程序直播】直播间管理接口

名称 功能说明
创建直播间 该接口可直接创建直播间,创建成功后直播间将在直播间列表展示
获取直播房间列表 该接口可获取直播房间列表
获取直播间回放 该接口可在直播结束后拿到回放源视频
直播间导入商品 调用此接口往指定直播间导入已入库的商品

一、简介

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

二、接口文档

1.创建直播间

接口说明:

调用此接口创建直播间,创建成功后将在直播间列表展示

调用频率

调用额度:10000次/一天

请求方式

POST

请求URL

https://api.weixin.qq.com/wxaapi/broadcast/room/create?access_token=

请求参数示例: json

{
      name: "测试直播房间1",  // 房间名字
      coverImg: "",   // 通过 uploadfile 上传,填写 mediaID
      startTime: 1588237130,   // 开始时间
      endTime: 1588237130 , // 结束时间
      anchorName: "zefzhang1",  // 主播昵称
      anchorWechat: "WxgQiao_04",  // 主播微信号
      shareImg: "" ,  //通过 uploadfile 上传,填写 mediaID
      type: 1 , // 直播类型,1 推流 0 手机直播
      screenType: 0,  // 1:横屏 0:竖屏
      closeLike: 0 , // 是否 关闭点赞 1 关闭
      closeGoods: 0, // 是否 关闭商品货架,1:关闭
      closeComment: 0 // 是否开启评论,1:关闭
}

请求参数含义

参数类型必填说明
nameString直播间名字,最短3个汉字,最长17个汉字,1个汉字相当于2个字符
coverImgString背景图,填入mediaID(mediaID获取后,三天内有效);图片mediaID的获取,请参考以下文档: https://developers.weixin.qq.com/doc/offiaccount/Asset_Management/New_temporary_materials.html;直播间背景图,图片规则:建议像素1080*1920,大小不超过2M
startTimeNumber直播计划开始时间(开播时间需要在当前时间的10分钟后 并且 开始时间不能在 6 个月后)
endTimeNumber直播计划结束时间(开播时间和结束时间间隔不得短于30分钟,不得超过24小时)
anchorNameString主播昵称,最短2个汉字,最长15个汉字,1个汉字相当于2个字符
anchorWechatString主播微信号,如果未实名认证,需要先前往“小程序直播”小程序进行实名验证, 小程序二维码链接:https://res.wx.qq.com/op_res/BbVNeczA1XudfjVqCVoKgfuWe7e3aUhokktRVOqf_F0IqS6kYR--atCpVNUUC3zr
subAnchorWechatString主播副号微信号,如果未实名认证,需要先前往“小程序直播”小程序进行实名验证, 小程序二维码链接:https://res.wx.qq.com/op_res/BbVNeczA1XudfjVqCVoKgfuWe7e3aUhokktRVOqf_F0IqS6kYR--atCpVNUUC3zr
createrWechatString创建者微信号
shareImgString分享图,填入mediaID(mediaID获取后,三天内有效);图片mediaID的获取,请参考以下文档: https://developers.weixin.qq.com/doc/offiaccount/Asset_Management/New_temporary_materials.html;直播间分享图,图片规则:建议像素800*640,大小不超过1M;
feedsImgString购物直播频道封面图,填入mediaID(mediaID获取后,三天内有效);图片mediaID的获取,请参考以下文档: https://developers.weixin.qq.com/doc/offiaccount/Asset_Management/New_temporary_materials.html; 购物直播频道封面图,图片规则:建议像素800*800,大小不超过100KB;
isFeedsPublicNumber是否开启官方收录 【1: 开启,0:关闭】,默认开启收录
typeNumber直播间类型 【1: 推流,0:手机直播】
screenTypeNumber横屏、竖屏 【1:横屏,0:竖屏】(横屏:视频宽高比为16:9、4:3、1.85:1 ;竖屏:视频宽高比为9:16、2:3)
closeLikeNumber是否关闭点赞 【0:开启,1:关闭】(若关闭,直播开始后不允许开启)
closeGoodsNumber是否关闭货架 【0:开启,1:关闭】(若关闭,直播开始后不允许开启)
closeCommentNumber是否关闭评论 【0:开启,1:关闭】(若关闭,直播开始后不允许开启)
closeReplayNumber是否关闭回放 【0:开启,1:关闭】默认关闭回放
closeShareNumber是否关闭分享 【0:开启,1:关闭】默认开启分享(直播开始后不允许修改)
closeKfNumber是否关闭客服 【0:开启,1:关闭】 默认关闭客服

正确返回示例

{
    "roomId": 33, //房间ID
    "errcode": 0
} 

返回参数含义

参数说明
roomId房间ID
qrcode_url"小程序直播" 小程序码

2.获取直播间列表

接口说明

调用此接口获取直播间列表及直播间信息

调用频率

调用额度:100000次/一天(与获取回放接口共用次数)

请求方式

POST

请求URL

https://api.weixin.qq.com/wxa/business/getliveinfo?access_token=

请求参数示例: json

{
    "start": 0, // 起始拉取房间,start = 0 表示从第 1 个房间开始拉取
    "limit": 10 // 每次拉取的个数上限,不要设置过大,建议 100 以内
}

请求参数含义

参数 类型 必填 说明
start Number 起始房间,0表示从第1个房间开始拉取
limit Number 每次拉取的房间数量,建议100以内

正确返回示例

{
    "errcode": 0,    // 错误码,0代表成功,1代表未创建直播间
    "errmsg": "ok"   // 错误信息
    "room_info":[{
        "name":"直播房间名"
        "roomid": 1,
        "cover_img":"http://http:\/\/mmbiz.qpic.cn\/mmbiz_jpg\Rl1RuuhdstSfZa8EEljedAYcbtX3Ejpdl2et1tPAQ37bdicnxoVialDLCKKDcPBy8Iic0kCiaiaalXg3EbpNKoicrweQ\/0?wx_fmt=jpeg",
        "share_img":"http://http:\/\/mmbiz.qpic.cn\/mmbiz_jpg\Rl1RuuhdstSfZa8EEljedAYcbtX3Ejpdl2et1tPAQ37bdicnxoVialDLCKKDcPBy8Iic0kCiaiaalXg3EbpNKoicrweQ\/0?wx_fmt=jpeg",
        "live_status": 101,
        "start_time": 1568128900,
        "end_time": 1568131200,
        "anchor_name":"里斯",
        "goods":[{
             "cover_img":"http://http:\/\/mmbiz.qpic.cn\/mmbiz_jpg\/Rl1RuuhdstSfZa8EEljedAYcbtX3Ejpdl2et1tPAQ37bdicnxoVialDLCKKDcPBy8Iic0kCiaiaalXg3EbpNKoicrweQ\/0?wx_fmt=jpeg",
             "url":"pages/index/index.html",
             "price":1100,
             "name":"茶杯"}],
        "total":1
    }]
}

返回参数含义

房间参数

参数 说明
name 直播间名称
roomid 直播间ID
cover_img 直播间背景图链接
share_img 直播间分享图链接
live_status 直播间状态。101:直播中,102:未开始,103已结束,104禁播,105:暂停,106:异常,107:已过期
start_time 直播间开始时间,列表按照start_time降序排列
end_time 直播计划结束时间
anchor_name 主播名
total 拉取房间总数

商品参数

参数 说明
cover_img 商品封面图链接
url 商品小程序路径
price 商品价格
name 商品名称

3.获取直播间回放

接口说明

调用接口获取已结束直播间的回放源视频(一般在直播结束后10分钟内生成,源视频无评论等内容)

调用频率

调用额度:100000次/一天

请求方法

POST

请求URL

https://api.weixin.qq.com/wxa/business/getliveinfo?access_token=

请求参数示例: json

{
     "action": "get_replay",  
     "room_id": 354,   
     "start": 0,   
     "limit": 10        
}

请求参数含义

参数 类型 必填 说明
action String 获取回放
room_id Number 直播间ID
start Number 起始拉取视频,0表示从第一个视频片段开始拉取
limit Number 每次拉取的数量,建议100以内

正确返回示例

{
     "live_replay":[{
         "expire_time":"",
         "create_time":"",
         "media_url":""
      }],
      "errcode": 0,
      "total": 1,
      "errmsg":"ok"
}

返回参数含义

参数 说明
expire_time 回放视频url过期时间
create_time 回放视频创建时间
media_url 回放视频链接
total 回放视频片段个数

4.直播间导入商品

接口说明

调用接口往指定直播间导入已入库的商品

调用频率

调用额度:10000次/一天

请求方法

POST

请求URL

https://api.weixin.qq.com/wxaapi/broadcast/room/addgoods?access_token=

请求参数示例: json

{
    "ids": [1150, 1111],  // 数组列表,可传入多个,里面填写 商品 ID
    "roomId": 2554
}

请求参数含义

参数 类型 必填 说明
ids Array<Number> 数组列表,可传入多个,里面填写 商品 ID
roomId Number 房间ID

正确返回示例

{
   "errcode": 0 // 0:成功
}

附录:错误码

-1:系统错误

阅读剩余部分

相关阅读 >>

微信小程序api 实时语音-监听在线状态变化事件

sdk数据库 aggregate划分记录

微信小程序api 蓝牙适配器接口

微信小程序 getpluginlist

sdk数据库 command聚合操作符聚合表达式

微信小程序api 地图-mapcontext对象

微信小程序云开发 api数据库插入记录

sdk数据库 database创建集合

微信小程序 用户信息-授权

微信小程序api 导航

更多相关阅读请进入《微信小程序》频道 >>




打赏

取消

感谢您的支持,我会继续努力的!

扫码支持
扫码打赏,您说多少就多少

打开支付宝扫一扫,即可进行扫码打赏哦

分享从这里开始,精彩与您同在

评论

管理员已关闭评论功能...