产品百科 |Ali RTC Linux 基本功能介绍(C++)-阿里云开发者社区

开发者社区> 阿里云视频云> 正文
登录阅读全文

产品百科 |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)
gslbgslb 服务地址,该参数是数组类型,当前请使用:["https://****"],请您通过业务服务器下发到客户端 SDK,不建议您将该地址固化在客户端代码。
agentagent 服务地址,该参数是数组类型,当前请使用:["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

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

分享:

分享视频云行业和技术趋势,打造“新内容”、“新交互”。

官方博客
官网链接