组件介绍
TUIPlayer 组件是一套开源的、完整的视频直播互动播放组件，它基于腾讯云 直播 Live SDK 和 即时通信 IM SDK ，实现直播播放，直播连麦等功能，同时支持弹幕、点赞、美颜等外挂插件，通过 TUIPlayer 组件您可以轻松实现直播视频拉流，快速搭建诸如秀场直播、电商直播等场景化解决方案。
组件集成
步骤一：下载并导入 TUIPlayer 组件
1. 单击进入 Github ，选择克隆或者下载小直播工程代码。
2. 拷贝 Android/tuiplayer 、Android/tuibarrage、Android/tuigift 等文件夹到您的工程中。
3. 在
setting.gradle 中完成导入，参考如下：include ':tuiplayer'include ':tuibarrage'include ':tuigift'
4. 在
app 的 build.gradle 文件中添加对 tuiplayer 等 moudle 的依赖：api project(':tuiplayer')api project(':tuibarrage')api project(':tuigift')
步骤二：配置权限及混淆规则
1. 在
AndroidManifest.xml 中配置 App 的权限，SDK 需要以下权限（6.0以上的 Android 系统需要动态申请相机、麦克风权限等）：<uses-permission android:name="android.permission.INTERNET" /><uses-permission android:name="android.permission.RECORD_AUDIO" /><uses-permission android:name="android.permission.CAMERA" />
2. 在 proguard-rules.pro 文件，将 SDK 相关类加入不混淆名单：
-keep class com.tencent.** { *; }
步骤三：初始化&创建组件
// 1. 创建TUIPlayer组件TUIPlayerView mTUIPlayerView = new TUIPlayerView(Context);// 2. 设置诸如拉流开始、拉流结束等事件监听mTUIPlayerView.setTUIPlayerViewListener(new TUIPlayerViewListener() {...}
步骤四：开始&停止播放
开始播放
mTUIPlayerView.startPlay(String url);
腾讯云直播支持两种播放协议：WebRTC 协议（即快直播，更低延时，更强抗性）、RTMP 协议、此处参数 URL 的生成，您可以参考 示例工程 中封装好的 Utils 方法，更多参数信息请参见 推拉流 URL。
停止播放
mTUIPlayerView.stopPlay();
步骤五：实现连麦功能（可选）
1. 开通云直播服务：
如果您未开通腾讯云直播相关服务，请先按照如下步骤开通相关服务并完成SDK鉴权：
创建应用并绑定 License ，并记录下
LICENSEURL、LICENSEURLKEY 等关键信息。按照如下方式，完成 SDK 推流鉴权：
V2TXLivePremier.setLicence(this, "您的LICENSEURL", "您的LICENSEURLKEY");
2. 开通连麦服务
因为连麦时需要更低的延时需求，需要在腾讯云直播控制台开通对应的连麦应用服务，如果您未开通，请登录云直播管理控制台选择 连麦应用 ，单击 新建连麦应用 输入应用名称（例如 
TUIPlayer ），然后在该应用的对应操作栏中，选择应用信息进入应用管理页，查看并记录应用的 SDKAppID 和 SECRETKEY（密钥） 。
3. 组件登录
因为连麦服务，需要观众与主播相互通信，所以需要进行单独登录，登录流程如下：
TUILogin.init(this, "您的SDKAppId", config, new V2TIMSDKListener() {@Overridepublic void onKickedOffline() { // 登录被踢下线通知（示例：账号在其他设备登录）}@Overridepublic void onUserSigExpired() { // userSig过期通知}});TUILogin.login("您的userId", "您的userSig", new V2TIMCallback() {@Overridepublic void onError(int code, String msg) {Log.d(TAG, "code: " + code + " msg:" + msg);}@Overridepublic void onSuccess() {}});
登录组件参数说明：
SDKAppID：即服务开通中记录到的 SDKAppID 信息。
SECRETKEY： 即服务开通中记录到的 SECRETKEY（密钥）。
userId：当前用户的 ID，字符串类型，长度不超过32字节，不支持使用特殊字符，建议使用英文或数字，可结合业务实际账号体系自行设置。
userSig：根据 SDKAppId、userId，Secretkey 等信息计算得到的安全保护签名，您可以单击 这里 直接在线生成一个调试的 UserSig，也可以参照我们的 示例工程 自行计算，更多信息见 如何计算及使用 UserSig 。
4. 开始&停止连麦
在 TUIPlayer 组件内部已经封装好了连麦功能，完成上述步骤后，即可单击连麦按钮发起&停止连麦，如您需要修改连麦 icon 或显示位置，详情请参见 连麦按钮 文件。
