产品百科 |Ali RTC Linux 基本功能介绍(C++)

简介: 阿里云 RTC 的基本功能包含初始化 SDK、加入频道、本地发布、录制和离开频道等。
  1. 下载最新的 SDK,更多信息,请参见 SDK 下载
  2. 初始化 SDK。
//初始化SDK
AliRTCSdk::Linux::EngineEventHandlerInterface *linuxEventHandler = new AliRTCSdk::Linux::FakeLinuxEventHandler();
AliRTCSdk::Linux::AliRTCEngineInterface *linuxEngine = (AliRTCSdk::Linux::AliRTCEngineInterface*)CreateAliRTCEngineInstance(linuxEventHandler, 42000, 45000, nullptr, nullptr);
// 如果创建失败,需要销毁EventHandler实例
if (linuxEngine == nullptr) {
    delete linuxEventHandler;
    linuxEventHandler = nullptr;
    return;
}

注意

  • 创建一个 SDK 实例需要占用一个系统端口进行音视频数据传输,建议端口范围设置为 42000~45000,并保证其他服务不会占用此范围的端口。
  • log:示例代码中传入的第四个参数,表示 log 存放的路径,设置为 nullptr,会默认放在 /tmp 路径下。
  • AliRtcCoreService:示例代码中传入的第五个参数,表示 AliRtcCoreService 可执行程序存放的绝对路径,设置为 nullptr,会默认在当前路径下寻找。
  1. 获得加入频道必须的频道鉴权令牌(Token)。
  • 您可以在控制台生成临时 Token 校验加入频道是否成功,详情请参见控制台生成 Token
  • 在安全要求更高的场景下,建议您在服务端生成 Token,详情请参见服务端生成 Token
  1. 加入频道。
AliRTCSdk::Linux::AuthInfo authInfo;
authInfo.appid = "";              //应用ID
authInfo.channel = room.c_str();  //频道ID
authInfo.userid = "";             //用户ID
authInfo.username = "";           //用户名称
authInfo.nonce = "";              //随机码     
authInfo.token = "";              //频道鉴权令牌
authInfo.timestamp = 1591430980;  //频道过期时间戳
int gslbCount = 1;
authInfo.gslb_count = gslbCount;
const char *gslbArray[gslbCount];
if (gslbCount > 0)
{
  for(int i = 0; i < gslbCount; i++)
  {
    gslbArray[i] = "*****";
  }
  authInfo.gslb = gslbArray;
}
int agentCount = 0;
authInfo.agent_count = agentCount;
const char *agentArray[agentCount];
if (agentCount > 0)
{
  for (int i = 0; i < agentCount; i++)
  {
    agentArray[i] = "";
  }
  authInfo.agent = agentArray;
}
// 初始化入会的设置
AliRTCSdk::Linux::JoinChannelConfig joinConfig;
// 关闭自动录制
joinConfig.recordingMode = AliRTCSdk::Linux::RecordingManually;
// 关闭自动推流
joinConfig.publishMode = AliRTCSdk::Linux::PublishManually;
// 入会
linuxEngine->JoinChannel(authInfo, joinConfig);
参数 描述
appid 应用 ID,在控制台应用管理页面创建和查看。
channel 频道 ID。1~64 位,支持大小写字母、数字、下划线(_)、短划线(-)。
userid 用户 ID。1~64 位,支持大小写字母、数字、下划线(_)、短划线(-)。

说明 同一个用户 ID 在其他端登录,先入会的端会被后入会的端踢出频道。

username 用户名。
nonce 随机码。需要加上前缀 AK-,由字母 [a-zA-Z] 和数字 [0-9] 组成,不包含特殊字符,最大 64 字节。例如:AK-2b9be4b25c2d38c409c376ffd2372be1。
timestamp 频道过期时间戳。代表令牌有效时间为当前时间 + 所选择小时数。
token 频道鉴权令牌,计算方法:token = sha256(appId + appKey + channel + userId + nonce + timestamp)
gslb gslb 服务地址,该参数是数组类型,当前请使用:["https://****"],请您通过业务服务器下发到客户端 SDK,不建议您将该地址固化在客户端代码。
agent agent 服务地址,该参数是数组类型,当前请使用:["https://****"],请您通过业务服务器下发到客户端 SDK,不建议您将该地址固化在客户端代码。
  1. 发布或取消发布本地流。
  • 自动发布模式:加入频道成功后,即可发布本地流,无需再次调用 publish 接口。
  • 手动发布模式:加入频道成功后,可通过以下接口发布本地流。

在发布 Yuv 和 Pcm 数据之前,需要设置推流的音视频参数。

// 开启Yuv输入,使用视频流(原相机流)进行推送
// 注意:第二个参数useTexture目前只能设置为false
linuxEngine->SetExternalVideoSource(true, false, AliRTCSdk::Linux::VideoSourceCamera);
// 开启Pcm输入
// 第二个参数为pcm的采样率,请根据实际情况设置
// 第三个参数为pcm的channel数,请根据实际情况设置
linuxEngine->SetExternalAudioSource(true, 16000, 2);

如果发布过程中需要变更配置或者停止发布,需要按如下流程先重新设置配置参数,然后再调用 publish 接口。
说明 Linux SDK 通过原相机流和屏幕流通道传递视频流,Linux SDK 不支持摄像头采集视频。

//设置是否推视频流(原相机流)。true表示允许发布,false表示不允许。
linuxEngine->ConfigLocalCameraPublish(true);
//设置是否推音频流。true表示允许发布,false表示不允许。 
linuxEngine->ConfigLocalAudioPublish(true);
//设置是否推视频流(原屏幕流)。true表示允许发布,false表示不允许。
linuxEngine->ConfigLocalScreenPublish(true);
//设置是否推次要视频流。true表示允许发布,false表示不允许。
linuxEngine->ConfigLocalSimulcast(true, AliRTCSdk::Linux::VideoSourceCamera);
linuxEngine->publish();
while (true) {
    ...
   // 推Yuv数据
   linuxEngine->PushExternalVideoFrame(&sample, AliRTCSdk::Linux::VideoSourceCamera);
   // 推Pcm数据
   linuxEngine->PushExternalAudioFrameRawData(cache_buf, frame_length, 0);
}

取消发布本地流。

// 设置是否推视频流(原相机流)
linuxEngine->ConfigLocalCameraPublish(false);
// 设置是否推音频流
linuxEngine->ConfigLocalAudioPublish(false);
// 设置是否推视频流(原屏幕流)
linuxEngine->ConfigLocalScreenPublish(false);
// 设置是否推次要视频流
linuxEngine->ConfigLocalSimulcast(false, AliRTCSdk::Linux::VideoSourceCamera);
linuxEngine->publish();

发布和取消发布本地流回调代码如下所示。

/**
* @brief 推流结果回调
* @param result 返回0表示成功,返回其他表示失败
* @param isPublished true表示推流成功,false表示停止推流
*/
virtual void OnPublishChangedNotify(int result, bool isPublished) = 0;
  1. 录制和取消录制。
  • 自动录制模式:加入频道成功后,无需调用以下接口,即可开始录制。
  • 手动录制模式:加入频道成功后,可通过以下接口进行录制操作。

开始录制。

linuxEngine->StartRecording();

取消录制。

linuxEngine->StopRecording();

录制回调示例代码如下所示。

/**
* @brief 远端用户上线回调
* @param uid 远端用户ID
*/
virtual void OnRemoteUserOnLineNotify(const char * uid) = 0;
/**
* @brief 远端用户下线回调
* @param uid 远端用户ID
*/
virtual void OnRemoteUserOffLineNotify(const char * uid) = 0;
/**
* @brief 音频原始数据的回调
* @param frame 音频原始数据
*/
virtual void OnAudioFrameReceived(const AliRTCSdk::Linux::AudioFrame * frame) = 0;
/**
* @brief 视频原始数据的回调
* @param uid 远端用户ID
* @param frame 视频原始数据
*/
virtual void OnVideoFrameReceived(const char * uid, const AliRTCSdk::Linux::VideoFrame * frame) = 0;
  1. 离开频道。
linuxEngine->LeaveChannel();
  1. 销毁 SDK。
linuxEngine->Release();
linuxEngine = nullptr;

接口详情请参见 AliRtcEngine 接口


「视频云技术」你最值得关注的音视频技术公众号,每周推送来自阿里云一线的实践技术文章,在这里与音视频领域一流工程师交流切磋。

image.png

相关文章
|
3天前
|
存储 网络协议 Ubuntu
【Linux开发实战指南】基于UDP协议的即时聊天室:快速构建登陆、聊天与退出功能
UDP 是一种无连接的、不可靠的传输层协议,位于IP协议之上。它提供了最基本的数据传输服务,不保证数据包的顺序、可靠到达或无重复。与TCP(传输控制协议)相比,UDP具有较低的传输延迟,因为省去了建立连接和确认接收等过程,适用于对实时性要求较高、但能容忍一定数据丢失的场景,如在线视频、语音通话、DNS查询等。 链表 链表是一种动态数据结构,用于存储一系列元素(节点),每个节点包含数据字段和指向下一个节点的引用(指针)。链表分为单向链表、双向链表和循环链表等类型。与数组相比,链表在插入和删除操作上更为高效,因为它不需要移动元素,只需修改节点间的指针即可。但访问链表中的元素不如数组直接,通常需要从
|
21天前
|
存储 网络协议 编译器
【干货总结】Linux C/C++面试知识点
Linux C/C++基础与进阶知识点,不仅用于面试,平时开发也用得上!
442 8
|
15天前
|
Linux vr&ar C语言
Linux怎样更新Centos下Gcc版本支持C17?Centos7快速安装gcc8.3.1 可支持C++17(附gcc相关链接整理)
Linux怎样更新Centos下Gcc版本支持C17?Centos7快速安装gcc8.3.1 可支持C++17(附gcc相关链接整理)
56 2
|
18天前
|
Linux C++
c++高级篇(三) ——Linux下IO多路复用之poll模型
c++高级篇(三) ——Linux下IO多路复用之poll模型
|
18天前
|
缓存 监控 网络协议
c++高级篇(二) ——Linux下IO多路复用之select模型
c++高级篇(二) ——Linux下IO多路复用之select模型
|
3天前
|
负载均衡 Java Linux
黑马头条01,环境搭建,今日头条的介绍,今日头条的功能架构图,技术栈的说明,服务层,nacos(奶靠丝)安装,安装在Linux服务器上环境准备,
黑马头条01,环境搭建,今日头条的介绍,今日头条的功能架构图,技术栈的说明,服务层,nacos(奶靠丝)安装,安装在Linux服务器上环境准备,
|
1月前
|
Linux C++
Linux C/C++ main函数
Linux C/C++ main函数
|
10天前
|
Web App开发 Linux 数据处理
深入理解Linux命令pkill:功能、原理与最佳实践
**pkill命令详解:在Linux中,pkill用于按进程名终止进程,简化了通过PID管理进程的步骤。它利用正则匹配支持模糊查找,可发送不同信号如SIGTERM或SIGKILL。常用示例包括:终止指定进程名、按用户或终端终止进程,以及使用-f进行模糊匹配。注意谨慎使用,避免误杀重要进程,先发送SIGTERM,无效再用SIGKILL。了解其权限需求和配合ps命令使用,能提升系统管理效率。**
|
10天前
|
Java Linux 网络安全
Linux常用50个命令分享:功能、示例与实用技巧
Linux常用50个命令分享:功能、示例与实用技巧
|
11天前
|
域名解析 网络协议 程序员
程序员必知:【转】adns解析库——域名解析实例(C++、linux)
程序员必知:【转】adns解析库——域名解析实例(C++、linux)
18 0