产品百科 |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

相关文章
|
29天前
|
网络协议 安全 Linux
Linux C/C++之IO多路复用(select)
这篇文章主要介绍了TCP的三次握手和四次挥手过程,TCP与UDP的区别,以及如何使用select函数实现IO多路复用,包括服务器监听多个客户端连接和简单聊天室场景的应用示例。
86 0
|
29天前
|
存储 Linux C语言
Linux C/C++之IO多路复用(aio)
这篇文章介绍了Linux中IO多路复用技术epoll和异步IO技术aio的区别、执行过程、编程模型以及具体的编程实现方式。
66 1
Linux C/C++之IO多路复用(aio)
|
29天前
|
资源调度 Linux 调度
Linux c/c++之进程基础
这篇文章主要介绍了Linux下C/C++进程的基本概念、组成、模式、运行和状态,以及如何使用系统调用创建和管理进程。
29 0
|
27天前
|
存储 C++ UED
【实战指南】4步实现C++插件化编程,轻松实现功能定制与扩展
本文介绍了如何通过四步实现C++插件化编程,实现功能定制与扩展。主要内容包括引言、概述、需求分析、设计方案、详细设计、验证和总结。通过动态加载功能模块,实现软件的高度灵活性和可扩展性,支持快速定制和市场变化响应。具体步骤涉及配置文件构建、模块编译、动态库入口实现和主程序加载。验证部分展示了模块加载成功的日志和配置信息。总结中强调了插件化编程的优势及其在多个方面的应用。
201 61
|
26天前
|
Ubuntu Linux 编译器
Linux/Ubuntu下使用VS Code配置C/C++项目环境调用OpenCV
通过以上步骤,您已经成功在Ubuntu系统下的VS Code中配置了C/C++项目环境,并能够调用OpenCV库进行开发。请确保每一步都按照您的系统实际情况进行适当调整。
208 3
|
29天前
|
资源调度 Linux 调度
Linux C/C++之线程基础
这篇文章详细介绍了Linux下C/C++线程的基本概念、创建和管理线程的方法,以及线程同步的各种机制,并通过实例代码展示了线程同步技术的应用。
23 0
Linux C/C++之线程基础
|
29天前
|
Linux C++
Linux C/C++之IO多路复用(poll,epoll)
这篇文章详细介绍了Linux下C/C++编程中IO多路复用的两种机制:poll和epoll,包括它们的比较、编程模型、函数原型以及如何使用这些机制实现服务器端和客户端之间的多个连接。
22 0
Linux C/C++之IO多路复用(poll,epoll)
|
29天前
|
网络协议 Linux 网络性能优化
Linux C/C++之TCP / UDP通信
这篇文章详细介绍了Linux下C/C++语言实现TCP和UDP通信的方法,包括网络基础、通信模型、编程示例以及TCP和UDP的优缺点比较。
35 0
Linux C/C++之TCP / UDP通信
|
29天前
|
消息中间件 Linux API
Linux c/c++之IPC进程间通信
这篇文章详细介绍了Linux下C/C++进程间通信(IPC)的三种主要技术:共享内存、消息队列和信号量,包括它们的编程模型、API函数原型、优势与缺点,并通过示例代码展示了它们的创建、使用和管理方法。
26 0
Linux c/c++之IPC进程间通信
|
29天前
|
Linux C++
Linux c/c++进程间通信(1)
这篇文章介绍了Linux下C/C++进程间通信的几种方式,包括普通文件、文件映射虚拟内存、管道通信(FIFO),并提供了示例代码和标准输入输出设备的应用。
20 0
Linux c/c++进程间通信(1)