直播 SDK 摄像头推流-无 UI 集成方案-文档中心-腾讯云

功能概述
摄像头推流，是指采集手机摄像头的画面以及麦克风的声音，进行编码之后再推送到直播云平台上。腾讯云 LiteAVSDK 通过V2TXLivePusher接口提供摄像头推流能力，如下是 SDK API-Example 工程中演示摄像头推流的相关操作界面：
﻿
﻿
特别说明
真机调试： 由于 SDK 大量使用 Android 系统的音视频接口，这些接口在仿真模拟器下往往不能工作，推荐您尽量使用真机调试。
示例代码
所属平台
GitHub 地址
关键类
iOS
Github
LivePushCameraViewController.m
Android
Github
LivePushCameraActivity.java
Flutter
Github
live_camera_push.dart
功能对接
1. 下载 SDK 开发包
﻿下载 SDK 开发包，并按照 SDK 集成指引 将 SDK 嵌入您的 App 工程中。
2. 给 SDK 配置 License 授权
1. 获取 License 授权：
若您已获得相关 License 授权，需在 云直播控制台 获取 License URL 和 License Key。
 
﻿
﻿
若您暂未获得 License 授权，需先参考 新增与续期 License 进行申请。
2. 在您的 App 调用 SDK 相关功能之前（建议在 Application 类中）进行如下设置：
public class MApplication extends Application {
﻿
@Override
public void onCreate() {
 super.onCreate();
 String licenceURL = ""; // 获取到的 licence url
 String licenceKey = ""; // 获取到的 licence key
 V2TXLivePremier.setLicence(this, licenceURL, licenceKey);
 V2TXLivePremier.setObserver(new V2TXLivePremierObserver() {
         @Override
         public void onLicenceLoaded(int result, String reason) {
             Log.i(TAG, "onLicenceLoaded: result:" + result + ", reason:" + reason);
         }
     });
}
注意
License 中配置的 packageName 必须和应用本身一致，否则会推流失败。
3. 初始化 V2TXLivePusher 组件
创建一个 V2TXLivePusher 对象，该对象负责完成推流的主要工作。
// 指定对应的直播协议为 RTMP，该协议不支持连麦
V2TXLivePusher mLivePusher = new V2TXLivePusherImpl(this, V2TXLiveDef.V2TXLiveMode.TXLiveMode_RTMP);
// 指定对应的直播协议为 RTC，该协议支持连麦。如果在直播过程中有连麦需求，需要选择该协议
V2TXLivePusher mLivePusher = new V2TXLivePusherImpl(this, V2TXLiveDef.V2TXLiveMode.TXLiveMode_RTC);
说明
如果您有连麦需求，需要创建V2TXLivePusher对象时选择RTC协议。RTC协议与RTMP协议在 API 使用上没有区别。
4. 开启摄像头预览
想要开启摄像头的预览画面，您需要先给 SDK 提供一个用于显示视频画面的TXCloudVideoView对象，由于TXCloudVideoView是继承自 Android 中的 FrameLayout，所以您可以：
1. 直接在 xml 文件中添加一个视频渲染控件：
<com.tencent.rtmp.ui.TXCloudVideoView
 android:id="@+id/pusher_tx_cloud_view"
 android:layout_width="match_parent"
 android:layout_height="match_parent" />
2. 通过调用 V2TXLivePusher 中的startCamera接口开启当前手机摄像头的预览画面。
// 启动本地摄像头预览
TXCloudVideoView mPusherView = (TXCloudVideoView) findViewById(R.id.pusher_tx_cloud_view);
mLivePusher.setRenderView(mPusherView);
mLivePusher.startCamera(true);
mLivePusher.startMicrophone();
5. 启动和结束推流
1. 如果已经通过startCamera接口启动了摄像头预览，就可以调用 V2TXLivePusher 中的 startPush 接口开始推流。
说明
如果在 第3步 中选择 RTMP 协议推流，推流地址的生成请参见 RTMP 地址。
如果在 第3步 中选择 RTC 协议推流，推流地址的生成请参见 RTC 地址。
// 根据推流协议传入对应的 URL 即可启动推流， RTMP 协议以 rtmp:// 开头，该协议不支持连麦
String url = "rtmp://test.com/live/streamid?txSecret=xxxxx&txTime=xxxxxxxx";
// 根据推流协议传入对应的 URL 即可启动推流， RTC 协议以 trtc:// 开头，该协议支持连麦
String url = "trtc://cloud.tencent.com/push/streamid?sdkappid=1400188888&userId=A&usersig=xxxxx";
int ret = mLivePusher.startPush(url);
if (ret == V2TXLIVE_ERROR_INVALID_LICENSE) {
 Log.i(TAG, "startRTMPPush: license 校验失败");
}
注意
返回 V2TXLIVE_ERROR_INVALID_LICENSE 的原因？
如果 startPush 接口返回 V2TXLIVE_ERROR_INVALID_LICENSE，则代表您的 License 校验失败了，请检查 第2步：给 SDK 配置 License 授权 中设置的 url 和 key。
2. 推流结束后，可以调用 V2TXLivePusher 中的 stopPush 接口结束推流。
// 结束推流
mLivePusher.stopPush();
6. 纯音频推流
如果您的直播场景是纯音频直播，不需要视频画面，那么您可以不执行 第4步 中打开摄像头的操作，仅仅打开麦克风即可。
mLivePusher.startMicrophone();
// 根据推流协议传入对应的 URL 即可启动推流， RTMP 协议以 rtmp:// 开头，该协议不支持连麦
String url = "rtmp://test.com/live/streamid?txSecret=xxxxx&txTime=xxxxxxxx";
// 根据推流协议传入对应的 URL 即可启动推流， RTC 协议以 trtc:// 开头，该协议支持连麦
String url = "trtc://cloud.tencent.com/push/streamid?sdkappid=1400188888&userId=A&usersig=xxxxx";
int ret = mLivePusher.startPush(url);
说明
如果您启动纯音频推流，但是 RTMP、FLV 、HLS 格式的播放地址拉不到流，那是因为线路配置问题，请 提工单 联系我们帮忙修改配置。
7. 设定画面清晰度
调用 V2TXLivePusher 中的 setVideoQuality 接口，可以设定观众端的画面清晰度。之所以说是观众端的画面清晰度，是因为主播看到的视频画面是未经编码压缩过的高清原画，不受设置的影响。而setVideoQuality设定的视频编码器的编码质量，观众端可以感受到画质的差异。详情请参见 设定画面质量。
8. 美颜美白和红润特效
﻿
﻿

调用 V2TXLivePusher 中的 getBeautyManager 接口可以获取 TXBeautyManager 实例进一步设置美颜效果。
美颜风格
SDK 内置三种不同的磨皮算法，每种磨皮算法即对应一种美颜风格，您可以选择最适合您产品定位的方案。定义见 TXLiveConstants.java 文件：
美颜风格
效果说明
BEAUTY_STYLE_SMOOTH
光滑，适用于美女秀场，效果比较明显
BEAUTY_STYLE_NATURE
自然，磨皮算法更多地保留了面部细节，主观感受上会更加自然
BEAUTY_STYLE_PITU
由上海优图实验室提供的美颜算法，磨皮效果介于光滑和自然之间，比光滑保留更多皮肤细节，比自然磨皮程度更高
美颜风格可以通过 TXBeautyManager 的setBeautyStyle接口设置：
美颜风格
设置方式
接口说明
美颜级别
通过 TXBeautyManager 的 setBeautyLevel 设置
取值范围0 - 9； 0表示关闭，1 - 9值越大，效果越明显
美白级别
通过 TXBeautyManager 的 setWhitenessLevel 设置
取值范围0 - 9； 0表示关闭，1 - 9值越大，效果越明显
红润级别
通过 TXBeautyManager 的 setRuddyLevel 设置
取值范围0 - 9； 0表示关闭，1 - 9值越大，效果越明显
9. 色彩滤镜效果
﻿
﻿
﻿
调用 V2TXLivePusher 中的 getBeautyManager 接口可以获取 TXBeautyManager 实例进一步设置美色彩滤镜效果。
调用 TXBeautyManager 的setFilter接口可以设置色彩滤镜效果。所谓色彩滤镜，是指一种将整个画面色调进行区域性调整的技术，例如将画面中的淡黄色区域淡化实现肤色亮白的效果，或者将整个画面的色彩调暖让视频的效果更加清新和温和。我们的设计师团队提供了17种默认的 色彩滤镜 供您使用。
调用 TXBeautyManager 的setFilterStrength接口可以设定滤镜的浓度，设置的浓度越高，滤镜效果也就越明显。
// 选择期望的色彩滤镜文件，滤镜文件可以在小直播 App 的资源文件中获取（以 tuibeauty_filter_ 开头的 .png 文件）。
Bitmap filterBmp = decodeResource(getResources(), R.drawable.tuibeauty_filter_biaozhun);
mLivePusher.getBeautyManager().setFilter(filterBmp);
mLivePusher.getBeautyManager().setFilterStrength(0.5f);
10. 设备管理
V2TXLivePusher 提供了一组 API 用户控制设备的行为。您通过getDeviceManager获取 TXDeviceManager 实例进一步进行设备管理，详细用法请参见 TXDeviceManager API。
﻿
﻿
11. 观众端的镜像效果
通过调用 V2TXLivePusher 的 setEncoderMirror 可以改变观众端观看到的镜像效果。之所以说是观众端的镜像效果，是因为当主播在使用前置摄像头直播时，默认情况下自己看到的画面会被 SDK 反转，这时主播就像照镜子一样，观众看到的效果和主播看到的是一致的。如下图所示：
﻿
﻿
12. 横屏推流
大多数情况下，主播习惯以“竖屏持握”手机进行直播拍摄，观众端看到的也是竖屏分辨率的画面（例如 540 × 960 这样的分辨率）；有时主播也会“横屏持握”手机，这时观众端期望能看到是横屏分辨率的画面（例如 960 × 540 这样的分辨率），如下图所示：
﻿

V2TXLivePusher 默认推出的是竖屏分辨率的视频画面，如果希望推出横屏分辨率的画面，可以修改setVideoQuality接口的参数来设定观众端的画面横竖屏模式。
V2TXLiveDef.V2TXLiveVideoEncoderParam param = new V2TXLiveDef.V2TXLiveVideoEncoderParam(V2TXLiveDef.V2TXLiveVideoResolution.V2TXLiveVideoResolution960x540);
param.videoResolutionMode = isLandscape ? V2TXLiveVideoResolutionModeLandscape : V2TXLiveVideoResolutionModePortrait;
mLivePusher.setVideoQuality(param);
13. 音效设置
调用 V2TXLivePusher 中的getAudioEffectManager获取 TXAudioEffectManager 实例可以实现背景混音、耳返、混响等音效功能。背景混音是指主播在直播时可以选取一首歌曲伴唱，歌曲会在主播的手机端播放出来，同时也会被混合到音视频流中被观众端听到，所以被称为“混音”。
﻿
﻿
调用 TXAudioEffectManager 中的enableVoiceEarMonitor选项可以开启耳返功能，“耳返”指的是当主播戴上耳机来唱歌时，耳机中要能实时反馈主播的声音。
调用 TXAudioEffectManager 中的setVoiceReverbType接口可以设置混响效果，例如 KTV、会堂、磁性、金属等，这些效果也会作用到观众端。
调用 TXAudioEffectManager 中的setVoiceChangerType接口可以设置变调效果，例如“萝莉音”，“大叔音”等，用来增加直播和观众互动的趣味性，这些效果也会作用到观众端。
﻿
﻿
﻿
说明
详细用法请参见 TXAudioEffectManager API。
14. 设置 Logo 水印
设置 V2TXLivePusher 中的 setWatermark 可以让 SDK 在推出的视频流中增加一个水印，水印位置位是由传入参数(x, y, scale)所决定。
SDK 所要求的水印图片格式为 PNG 而不是 JPG，因为 PNG 图片格式有透明度信息，因而能够更好地处理锯齿等问题（将 JPG 图片修改后缀名是不起作用的）。
(x, y, scale)参数设置的是水印图片相对于推流分辨率的归一化坐标。假设推流分辨率为：540 × 960，该字段设置为：（0.1，0.1，0.1），则水印的实际像素坐标为：（540 × 0.1，960 × 0.1，水印宽度 × 0.1，水印高度会被自动计算）。
// 设置视频水印
mLivePusher.setWatermark(BitmapFactory.decodeResource(getResources(),R.drawable.watermark), 0.03f, 0.015f, 1f);
15. 主播端弱网提醒
如果主播在推流时遇到网络很差的情况，需要有一个友好的提示，提示主播应当检查网络。
﻿
﻿
通过 V2TXLivePusherObserver 里的 onWarning 可以捕获 V2TXLIVE_WARNING_NETWORK_BUSY 事件，它代表当前主播的网络已经非常糟糕，出现此事件即代表观众端会出现卡顿。此时就可以像上图一样在 UI 上弹出一个“弱网提示”。
@Override
public void onWarning(int code, String msg, Bundle extraInfo) {
    if (code == V2TXLiveCode.V2TXLIVE_WARNING_NETWORK_BUSY) {
        showNetBusyTips(); // 显示网络繁忙的提示
    }
}
16. 发送 SEI 消息
调用 V2TXLivePusher 中的 sendSeiMessage 接口可以发送 SEI 消息。所谓 SEI，是视频编码数据中规定的一种附加增强信息，平时一般不被使用，但我们可以在其中加入一些自定义消息，这些消息会被直播 CDN 转发到观众端。使用场景有：
答题直播：推流端将题目下发到观众端，可以做到“音-画-题”高度协调同步。
秀场直播：推流端将歌词下发到观众端，可以在播放端实时绘制出歌词特效，因而不受视频编码的降质影响。
在线教育：推流端将激光笔和涂鸦操作下发到观众端，可以在播放端实时地划圈划线。
由于自定义消息是直接被塞入视频数据中的，所以不能太大（几个字节比较合适），一般常用于塞入自定义的时间戳等信息。
//Android 示例代码
int payloadType = 5;
String msg = "test";
mTXLivePusher.sendSeiMessage(payloadType, msg.getBytes("UTF-8"));
常规开源播放器或者网页播放器是不能解析 SEI 消息的，必须使用 LiteAVSDK 中自带的 V2TXLivePlayer 才能解析这些消息：
1. 设置：
int payloadType = 5;
mTXLivePlayer.enableReceiveSeiMessage(true, payloadType)
2. 当 V2TXLivePlayer 所播放的视频流中有 SEI 消息时，会通过 V2TXLivePlayerObserver 中的 onReceiveSeiMessage 回调来接收该消息。
事件处理
事件监听
SDK 通过 V2TXLivePusherObserver 代理来监听推流相关的事件通知和错误通知，详细的事件表和错误码表请参见 错误码表。
错误通知
SDK 发现部分严重问题，推流无法继续。
事件 ID
数值
含义说明
V2TXLIVE_ERROR_FAILED
-1
暂未归类的通用错误
V2TXLIVE_ERROR_INVALID_PARAMETER
-2
调用 API 时，传入的参数不合法
V2TXLIVE_ERROR_REFUSED
-3
API 调用被拒绝
V2TXLIVE_ERROR_NOT_SUPPORTED
-4
当前 API 不支持调用
V2TXLIVE_ERROR_INVALID_LICENSE
-5
license 不合法，调用失败
V2TXLIVE_ERROR_REQUEST_TIMEOUT
-6
请求服务器超时
V2TXLIVE_ERROR_SERVER_PROCESS_FAILED
-7
服务器无法处理您的请求
警告事件
SDK 发现部分警告问题，但 WARNING 级别的事件都会触发一些尝试性的保护逻辑或者恢复逻辑，而且有很大概率能够恢复。
事件 ID
数值
含义说明
V2TXLIVE_WARNING_NETWORK_BUSY
1101
网络状况不佳：上行带宽太小，上传数据受阻
V2TXLIVE_WARNING_VIDEO_BLOCK
2105
当前视频播放出现卡顿
V2TXLIVE_WARNING_CAMERA_START_FAILED
-1301
摄像头打开失败
V2TXLIVE_WARNING_CAMERA_OCCUPIED
-1316
摄像头正在被占用中，可尝试打开其他摄像头
V2TXLIVE_WARNING_CAMERA_NO_PERMISSION
-1314
摄像头设备未授权，通常在移动设备出现，可能是权限被用户拒绝了
V2TXLIVE_WARNING_MICROPHONE_START_FAILED
-1302
麦克风打开失败
V2TXLIVE_WARNING_MICROPHONE_OCCUPIED
-1319
麦克风正在被占用中，例如移动设备正在通话时，打开麦克风会失败
V2TXLIVE_WARNING_MICROPHONE_NO_PERMISSION
-1317
麦克风设备未授权，通常在移动设备出现，可能是权限被用户拒绝了
V2TXLIVE_WARNING_SCREEN_CAPTURE_NOT_SUPPORTED
-1309
当前系统不支持屏幕分享
V2TXLIVE_WARNING_SCREEN_CAPTURE_START_FAILED
-1308
开始录屏失败，如果在移动设备出现，可能是权限被用户拒绝了
V2TXLIVE_WARNING_SCREEN_CAPTURE_INTERRUPTED
-7001
录屏被系统中断
﻿

所属平台	GitHub 地址	关键类
iOS	Github	LivePushCameraViewController.m
Android	Github	LivePushCameraActivity.java
Flutter	Github	live_camera_push.dart

美颜风格	效果说明
BEAUTY_STYLE_SMOOTH	光滑，适用于美女秀场，效果比较明显
BEAUTY_STYLE_NATURE	自然，磨皮算法更多地保留了面部细节，主观感受上会更加自然
BEAUTY_STYLE_PITU	由上海优图实验室提供的美颜算法，磨皮效果介于光滑和自然之间，比光滑保留更多皮肤细节，比自然磨皮程度更高

美颜风格	设置方式	接口说明
美颜级别	通过 TXBeautyManager 的 setBeautyLevel 设置	取值范围0 - 9； 0表示关闭，1 - 9值越大，效果越明显
美白级别	通过 TXBeautyManager 的 setWhitenessLevel 设置	取值范围0 - 9； 0表示关闭，1 - 9值越大，效果越明显
红润级别	通过 TXBeautyManager 的 setRuddyLevel 设置	取值范围0 - 9； 0表示关闭，1 - 9值越大，效果越明显

事件 ID	数值	含义说明
V2TXLIVE_ERROR_FAILED	-1	暂未归类的通用错误
V2TXLIVE_ERROR_INVALID_PARAMETER	-2	调用 API 时，传入的参数不合法
V2TXLIVE_ERROR_REFUSED	-3	API 调用被拒绝
V2TXLIVE_ERROR_NOT_SUPPORTED	-4	当前 API 不支持调用
V2TXLIVE_ERROR_INVALID_LICENSE	-5	license 不合法，调用失败
V2TXLIVE_ERROR_REQUEST_TIMEOUT	-6	请求服务器超时
V2TXLIVE_ERROR_SERVER_PROCESS_FAILED	-7	服务器无法处理您的请求

摄像头推流

本页目录：

功能概述

特别说明

示例代码

功能对接

1. 下载 SDK 开发包

2. 给 SDK 配置 License 授权

3. 初始化 V2TXLivePusher 组件

4. 开启摄像头预览

5. 启动和结束推流

6. 纯音频推流

7. 设定画面清晰度

8. 美颜美白和红润特效

美颜风格

9. 色彩滤镜效果

10. 设备管理

11. 观众端的镜像效果

12. 横屏推流

13. 音效设置

14. 设置 Logo 水印

15. 主播端弱网提醒

16. 发送 SEI 消息

事件处理

事件监听

错误通知

警告事件