Live/AndroidSDK
微博直播SDK接入方法-Android
阅读以下文档，帮助了解如何使用微博直播SDK。
目录 |
服务端文档
服务端直播接口wiki: 请参考直播OPEN API
接入方法
demo工程请参考：demo工程 ，直播相关接口请参考：直播接口参数。
1.申请微博授权接入权限，并导入授权SDK所需文件，详见 微博授权SDK说明文档 。
2.申请微博直播所需权限，需提交appKey、Android签名信息等，申请直播接口及直播互动接口权限，见直播权限申请。
3.参考weibosdkdemo工程，将WeiboLiveOpenapi.jar导入，新增类似WBLive*Activity相关的代码，用于调用WeiboLiveOpenApi中的接口；将sinalive_sdk_release.jar导入，新增类似PlayActivity相关的代码，用于调用sinalive_sdk_release中的接口。
4.创建直播：初始化WeiboLiveCreate类，设置参数后，调用createLive接口创建直播，解析回调函数返回值，并保存正确返回值留待推流、互动、删除等其他用途。注意：在创建直播时将进行开播权限验证，若无开播权限，将进入实名认证页面。被禁播的用户将弹窗提示。
5.更新直播：初始化WeiboLiveUpdate类，设置参数后，调用updateLive接口更新直播，解析回调函数返回值。
6.获取直播信息: 初始化WeiboLiveGetInfo类，设置参数后，调用getInfoLive接口获取直播信息，解析回调函数返回值。
7.删除直播：初始化WeiboLiveDelete类，设置参数后，调用deleteLive接口更新直播，解析回调函数返回值。
8.互动下行：初始化LiveMsgManager类，调用initClient建立长链接口监听，joinRoom加入房间，onNewMessage接收互动下行push消息。
常用类及名词解释
| 类名 | 用途 | 所属包 |
|---|---|---|
| Oauth2AccessToken | accessToken类 | 授权sdk |
| RequestListener | 接口事件回调，需要实现 | 授权sdk |
| WeiboException | 接口错误信息，需要实现 | 授权sdk |
| AccessTokenKeeper | 保存AccessToken | 授权sdk |
| WeiboLiveCreate | 新建直播对象，获取直播推流地址，并同时发微博 | 直播sdk |
| WeiboLiveDelete | 删除直播对象，不可逆（不删除微博） | 直播sdk |
| WeiboLiveGetInfo | 获取直播对象信息、互动信息等 | 直播sdk |
| WeiboLiveUpdate | 更新直播对象信息、状态等 | 直播sdk |
| LiveMsgManager | 互动SDK消息管理类 | 直播sdk |
以下参数在直播sdk接口初始化时使用
| 参数字段 | 字段类型 | 字段说明 |
|---|---|---|
| context | Context | Android app的上下文环境 |
| appKey | String | 申请权限时使用的appKey |
| accessToken | Oauth2AccessToken | 从授权sdk获取的token |
接口参数
创建直播类
| 接口名称 | 参数类型 | 说明 | 是否调用 |
|---|---|---|---|
| void setAc | Activity | 传递当前所属Activity | 必需 |
| void setTitle | String | 设置直播标题 | 必需 |
| void setWidth | String | 设置直播宽度 | 必需 |
| void setHeight | String | 设置直播高度 | 必需 |
| void setSummary | String | 设置微博文本内容，少于130汉字 | 非必需 |
| void setPublished | String | 微博是否发布，0：公开发布，1：仅自己可见，默认为0 | 非必需 |
| void setImage | String | 封面图地址，注意封面图的宽高和直播的宽高比例要一致，建议分辨率不要太高 | 非必需 |
| void setReplay | String | 是否录制，0：不录制，1：录制，默认为1 | 非必需 |
| void setPanoLive | String | 是否全景直播，0：不是，1：是，默认为0 | 非必需 |
| void createLive | RequestListener | 创建直播，并提供回调。onComplete表示接口成功返回，s为返回值；onWeiboException表示接口请求失败 | 必需 |
更新直播类
| 接口名称 | 参数类型 | 说明 | 是否调用 |
|---|---|---|---|
| void setId | String | 设置要更新的直播id | 必需 |
| void setTitle | String | 设置直播对象描述 | 非必需 |
| void setSummary | String | 设置微博文本内容，少于130汉字 | 非必需 |
| void setPublished | String | 设置是否重发微博，0：公开发布，1：仅自己可见，2：不发布，默认为2 | 非必需 |
| void setImage | String | 封面图地址，注意封面图的宽高和直播的宽高比例要一致，建议分辨率不要太高 | 非必需 |
| void setStop | String | 设置直播状态，0：直播中，1：直播结束，默认0 | 非必需 |
| void setReplayUrl | String | 设置直播回放地址 | 非必需 |
| void updateLive | RequestListener | 更新直播，并提供回调。onComplete表示接口成功返回，s为返回值；onWeiboException表示接口请求失败 | 必需 |
获取直播信息类
| 接口名称 | 参数类型 | 说明 | 是否调用 |
|---|---|---|---|
| void setId | String | 设置直播id | 必需 |
| void setDetail | String | 设置是否返回直播详情，0返回，1不返回，默认0 | 非必需 |
| void getInfoLive | RequestListener | 获取直播信息，并提供回调。onComplete表示接口成功返回，s为返回值；onWeiboException表示接口请求失败 | 必需 |
删除直播类
| 接口名称 | 参数类型 | 说明 | 是否调用 |
|---|---|---|---|
| void setId | String | 设置要删除的直播id | 必需 |
| void deleteLive | RequestListener | 删除直播，并提供回调。onComplete表示接口成功返回，s为返回值；onWeiboException表示接口请求失败 | 必需 |
直播互动类
| 接口名称 | 参数类型 | 说明 | 是否调用 |
|---|---|---|---|
| initClient | 初始化数据并建立长链接口监听，当执行完该方法后，长链回调接口会返回建立长链成功与失败的参数结果。 | 必需 | |
| joinRoom | String | 加入房间,roomId为需要加入的房间Id，当且仅当roomId是正确的有效的情况 下，才能加入成功，其他情况会加入失败，失败的原因可详细参照失败接口回调的数据结果。 | 必需 |
| exitRoom | String | 退出房间,roomId为需要退出的房间Id，当且仅当roomId是正确的有效的情况 下，才能退出成功，其他情况会退出失败，失败的原因可详细参照失败接口回调的数据结果。 | 必需 |
| exitRoom | String | 退出房间,roomId为需要退出的房间Id，当且仅当roomId是正确的有效的情况 下，才能退出成功，其他情况会退出失败，失败的原因可详细参照失败接口回调的数据结果。 | 必需 |
| sendMsg | String | 目前微博直播SDK支持最基本的文本消息发送。 参数:roomId为房间Id，content为需要发送的消息内容，offset为发消息时距离直播开始的时间间隔，type为消息类型。 | 必需 |
| sendLike | String | roomId为房间Id，content为需要发送的消息内容，praiseNum为用户 点赞次数。 | 必需 |
| onNewMessage | String | 接收所有SDK下行push消息类型数据。
参数：msgType为消息类型，model为接收的消息内容，requestId为本次互动请求的ID，可以用作本次请求的唯一标识，服务端也可以用该字段来定位请求和数据分析。 |
必需 |
消息类型
1 - 聊天消息
2 - 赞消息
3 - 点亮主播消息
4 - 禁言消息
5 - 礼物消息
6 - 公告消息
7 - 分享直播消息
8 - 关注主播消息
11 - 直播变更消息（房间的任何状态变更都会进行push）
12 - 加入/退出房间消息
13 - 打赏消息
14 - 管理员变更消息
15 - 系统消息（该消息"sender_info"字段为空,"send_info":{}
16 - 置顶/取消置顶评论消息
100 - 自定义消息类型
特此声明 用途:LiveMsgManager的作用是对微博SDK进行简单封装，具体微博直播 SDK的使用需要以微博直播SDK接入文档为准。
联系方式
接入及调试代码等工作，可联系jialu5@staff.sina.com.cn
