基础功能
更新时间:2020-10-16
概述
本文主要介绍了 SDK 功能中的常用功能和注意事项,例如登录和登出、获取直播列表、打开开播页、用户状态监测、订单信息获取等。
详细介绍
1. 登录账号
接入方 APP 在登录成功后,需要通过 server to server
交互 获取到 openID
和 token
后调用 SDK 接口进行绑定登录。具体获取 openID 和 token 可参考 服务端 SDK 集成 文档。
/**
* Called when login LinkV acount server successfully
* @param originUid origin user uid
* @param openID LinkV openID
* @param token LinkV user token
*/
LinkliveSDK.getInstance().onLoginSuccess(String originUid, String openID,String token);
// Called when the user logout
LinkliveSDK.getInstance().onLogout();
// login status check
LinkliveSDK.getInstance().isUserLogin();
2. 获取直播列表
列表视图
(1) 通过调用 fetchVideoListFragment 可以快速获取标准化 直播列表
的视图容器,该视图包含热门、关注、全部、附近、国家等选项卡。
将该容器添加到你想要展示的页面上完成列表的展示,该列表具备基础的直播信息元素,可以由我方定制开发。
// Get video list view
LinkliveSDK.getInstance().fetchVideoListFragment(Context context,ViewGroup container);
列表数据
(2) 直播列表数据也可以通过 fetchVideoListData 方法获取列表数据,由接入方客户端自定义开发UI界面。
/** Get the specified live broadcast
* @param from Feature or follow
* @param gender Get the broadcast of the specified gender
* @param page Start with 0
* @param complete Callback
*/
LinkliveSDK.getInstance().fetchVideoListData(int from, int page, int requestGender, LMVideoResponseCompleteListener complete);
3. 开始直播
开播过程中SDK会对当前客户端的摄像头和麦克风权限进行检测和申请,需要用户同意并授权才能使用直播功能,直播准备页面可以上传自定义直播封面、填写直播标题、选择直播标签、使用美颜滤镜开播。
/** Start broadcast
* @param context Context
*/
LinkliveSDK.getInstance().startBroadcast(Context context);
4. 跳转到指定直播间
SDK 提供 通过 vid 跳转到指定直播间的功能,传递 vid 给 SDK,SDK 会跳转到指定直播间。
/** Jump to the live room of the specified vid
* @param context Context
* @param vid vid
*/
LinkliveSDK.getInstance().jumpToLiveRoom(Context context, String vid)
5. 关闭当前显示的直播间
//关闭当前显示的直播间
LinkliveSDK.getInstance().closeLiveRoom();
6. 获取个人信息
/**
* Get personal information data
* @return AccountInfo personal information data
*/
AccountInfo accountInfo = LinkliveSDK.getInstance().getAccountInfo();
7. 触发登录
当用户没有登录时,点击直播间关注、送礼等会触发该回调方法,需在该方法中实现登录的相关操作。
/**
* Trigger login
* @param activity context
* @param flag
* @param from The source of the previous page
*/
public void startLogin(Context activity, int flag, int from);
8. SDK页面
打开个人页
// Navigate to personal page
LinkliveUIUtil.openPersonalPage(Context context);
打开搜索页
// Navigate to Search page
LinkliveUIUtil.openSearchPage(Context context);
打开排行榜页
// Navigate to leader board page
LinkliveUIUtil.openLeaderBoardPage(Context context);
9. 性别过滤
SDK 提供了首页数据列表性别过滤的功能,直接调用 SDK 的 showLiveListFilter 方法,可弹出选择性别框。
//Show filter panel to filter live list
LinkliveUIUtil.showLiveListFilter(Fragment fragment);