Live/thirdapi
第11行: | 第11行: | ||
第四步:平台配置分享url第三方回调,解析直播播放card | 第四步:平台配置分享url第三方回调,解析直播播放card | ||
− | + | 回调触发机制:新的url分享到微博默认回调,平台永久缓存对应的直播对象信息,之后除非触发某种更新机制,会再次回调 | |
第五步:平台申请直播业务bizid,配置客户端和PC端的直播card解析 | 第五步:平台申请直播业务bizid,配置客户端和PC端的直播card解析 | ||
− | + | 第六步:第三方主动更新直播信息,平台分配加密秘钥,详见下文 | |
==第三方提供回调接口== | ==第三方提供回调接口== |
2016年6月3日 (五) 21:29的版本
目录 |
直播服务第三方接入
第三方直播源接入流程
适用有自己的直播CDN服务的第三方接入:
第一步:第三方申请微博开发者,获取平台分配的应用appkey 详见新手指南
第二步:第三方提供分享到微博的直播播放落地页url
第三步:第三方提供回调接口,平台提供domainid,详见下文
第四步:平台配置分享url第三方回调,解析直播播放card
回调触发机制:新的url分享到微博默认回调,平台永久缓存对应的直播对象信息,之后除非触发某种更新机制,会再次回调
第五步:平台申请直播业务bizid,配置客户端和PC端的直播card解析
第六步:第三方主动更新直播信息,平台分配加密秘钥,详见下文
第三方提供回调接口
URL : http://***.com/***?url=***
说明:由第三方提供该回调接口,返回完整的JSON格式的直播对象信息,参数url为透传第三方分享到微博的链接地址url
参数说明:
直播对象一级字段 | 二级字段 | 字段说明 |
---|---|---|
summary | - | 微博文本内容,分享到微博的文本内容 |
stream | hd_url | 直播高清地址 |
format | 直播地址格式 | |
ld_url | 直播标清地址 | |
urls | live_flv_hd | 直播高清地址-flv格式,如没有默认空 |
live_flv_ld | 直播标清地址-flv格式,如没有默认空 | |
rtmp_hd | 直播高清地址-rtmp格式,如没有默认空 | |
rtmp_ld | 直播标清地址-rtmp格式,如没有默认空 | |
live_hd | 直播高清地址-hls格式,如没有默认空 | |
live_ld | 直播标清地址-hls格式,如没有默认空,以上格式必须提供一种,如果没有分高标清,赋值成相同的地址 | |
replay_hd | 直播回放高清地址 | |
replay_ld | 直播回放标清地址 | |
image | width | 封面图宽 |
height | 封面图高 | |
url | 直播封面图地址 | |
author | id | 直播主播对应的微博用户id(uid),如果第三方没有对应的微博UID,第三方回调接口请直接返回错误提示 |
object_type | 直播主播类型,默认person | |
display_name | 直播主播微博昵称 | |
live | width | 直播流宽,直播流原始分辨率,根据这个宽高比信息自适应直播播放器显示横屏竖屏 |
height | 直播流高 | |
bitrate | 直播流码率 | |
id | - | 直播对象ID,一般默认规则(domainid:md5(url)),冒号之前为微博平台分配的域名ID,冒号之后保证唯一值 |
object_type | - | 直播对象类型,默认 live |
object_type_detail | - | 直播对象详情,默认微博直播“weibolive” |
mid | - | 直播主播分享的原创微博mid,目前第三方接入微博sdk的方式分享到微博无法获取到mid,只有通过服务层调用平台分享微博接口才能获取到mid,如没有默认空,影响互动打通等直播功能 |
display_name | - | 直播短链标题,默认“微博直播” |
title | - | 直播标题 |
status | - | 直播实时状态(0 未开始,1 直播中,2 直播删除, 3 直播结束) |
stime | - | 直播开始时间 |
etime | - | 直播结束时间 |
updated_at | - | 直播创建时间 |
duration | - | 直播持续时长 |
url | - | 直播落地页地址 |
target_url | - | 直播落地页地址 |
share_text | - | 直播分享文案 |
embed_code | - | 直播flash播放地址 |
scheme_app_ios | - | 呼起第三方直播ios app地址,默认空 |
scheme_app_android | - | 呼起第三方直播android app地址,默认空 |
app_ios_url | - | 呼起第三方直播ios app下载地址,默认空 |
app_android_url | - | 呼起第三方直播android app下载地址,默认空 |
示例:
{ summary: "【暴雨袭击江西南昌 央视记者正在直播】江西省南昌市昨晚迎来强降雨,27个站点降雨量超过100毫米,气象部门不断升级暴雨预警。今天,南昌市区多个路段出现积水,记者所在的立交桥积水深度超过1.5米,有车辆陷入积水中。央视新闻记者正在现场直播。(央视记者王舒畅)", stream: { hd_url: "http://***", format: "m3u8", url: "http://***" }, app_android_url: "", stime: "2016-06-02 11:24:46", id: "1042097:5d9361da897dfe7c7d1f343b74bee53d", object_type: "live", author: { id: "2656274875", object_type: "person", display_name: "央视新闻" }, title: "暴雨袭击南昌 央视记者正在直播", scheme_app_android: "", app_ios_url: "", scheme_app_ios: "", disable_replay: 0, share_text: "@央视新闻 正在直播中,场面异常火爆,小伙伴们速来围观... http://live.weibo.com/show?id=1042097:5d9361da897dfe7c7d1f343b74bee53d", live: { height: "450", width: "800", bitrate: "500" }, status: 3, urls: { live_ld: "http://***", replay_ld: "http://***", rtmp_ld: "rtmp://***", live_flv_ld: "http://***.flv", live_hd: "http://***", replay_hd: "http://***", rtmp_hd: "rtmp://***", live_flv_hd: "http://***.flv", }, object_type_detail: "weibolive", //第三方接入命名协商 image: { height: "450", width: "800", url: "http://ww3.sinaimg.cn/large/941f7a2fjw1f4gptlnkh0j20fk08rgo7.jpg" }, url: "http://live.weibo.com/show?id=1042097:5d9361da897dfe7c7d1f343b74bee53d", background_url: "", display_name: "微博直播", //微博短链上的文案显示 duration: 1218.599, updated_at: "2016-06-02", etime: "2016-06-02 12:01:01", embed_code: "http://****/v.swf", //第三方直播播放器 mid: "3981885077804051", target_url: "http://live.weibo.com/show?id=1042097:5d9361da897dfe7c7d1f343b74bee53d", }
更新直播信息接口
URL : http://live.weibo.com/proxy/updatestatus [POST]
说明:第三方直播对象的任何信息发生变更,需要调用该接口同步微博,比如直播状态变更、播放地址更新、回放地址生成、封面图更新等等
参数:
参数字段 | 字段必选 | 字段类型 | 字段说明 |
---|---|---|---|
source | true | string | 直播来源,即appkey |
uid | true | string | 直播主播的微博uid |
liveid | true | string | 直播ID,即直播对象中的id |
status | true | string | 直播状态,0:未直播 1:直播中 2:删除或举报 3:直播结束 4:直播延迟 |
url | true | string | 第三方直播落地页,即直播对象中的url |
sign | true | string | 签名校验,具体的加密算法见下文 |
useragent | false | string | 用户ua信息 |
返回:
参数字段 | 字段必选 | 字段说明 |
---|---|---|
code | string | 错误代码,0 请求正常,其他错误详见下文的错误代码说明 |
msg | string | 错误信息 |
data | string | 如果请求正常,返回直播对象信息 |
示例:
{ }
接口签名校验
每个接入的第三方会分配一个秘钥,根据微博提供的加密算法进行接口校验,加密算法微博平台单独文档提供
错误代码
错误码
错误码 | 错误msg | 描述 |
---|---|---|
10000 | sign error | sign值错误 |
10001 | id error | 直播id不存在 |
10002 | param loss | 字段为空 |
10003 | param error | 字段错误 |