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

简介: 阿里云 RTC 的基本功能包含创建实例、加入频道、本地发布、录制和离开频道等。

阿里云 RTC 的基本功能包含创建实例、加入频道、本地发布、录制和离开频道等。

前提条件

在实现基本功能前,请您确保下载最新 SDK,请参见 SDK 下载

获得加入频道必须的频道鉴权令牌(Token):

  • 您可以在控制台生成临时 Token 校验加入频道是否成功,详情请参见控制台生成 Token
  • 在安全要求更高的场景下,建议您在服务端生成 Token,详情请参见服务端生成 Token

说明 本文中的实现方法为主要功能方法,仅供参考,您可以根据业务需求进行实际开发。

  1. 初始化 SDK。
AliRTCLinuxEngineListener engineEventHandler = new EngineListener();
AliRTCLinuxEngine linuxEngine = AliRTCLinuxEngine.createInstance(engineEventHandler, 42000, 45000, null, CORE_SERVICE_PATH);

注意

  • 创建一个 SDK 实例需要占用一个系统端口进行音视频数据传输,建议端口范围设置为 42000~45000,并保证其他服务不会占用此范围的端口。
  • logPath:示例代码中传入的第四个参数,表示 logPath 存放的路径,设置为 null,会默认放在 /tmp 路径下。
  • AliRtcCoreService:示例代码中传入的第五个参数,表示 AliRtcCoreService 可执行程序存放的绝对路径,设置为 null,会默认在当前路径下寻找。
  1. 加入频道。
// TODO by user, need authinfo
AliRTCLinuxEngine.AuthInfo authInfo = new AliRTCLinuxEngine.AuthInfo();
authInfo.appid = "";     //应用ID
authInfo.channel = "";   //频道ID
authInfo.userid = "";    //用户ID
authInfo.username = "";  //用户名称
authInfo.nonce = "";     //随机码
authInfo.token = "";     //频道鉴权令牌
authInfo.timestamp = 0;  //频道过期时间戳
int gslbCount = 1;
authInfo.gslb_count = gslbCount;
String[] gslbArray = new String[gslbCount];
if (gslbCount > 0) {
    for (int i = 0; i < gslbCount; i++) {
        gslbArray[i] = "https://********.com";
    }
    authInfo.gslb = gslbArray;
}
int agentCount = 0;
authInfo.agent_count = agentCount;
String[] agentArray = new String[agentCount];
if (agentCount > 0) {
    for (int i = 0; i < agentCount; i++) {
        agentArray[i] = "https://********.com";
    }
    authInfo.agent = agentArray;
}
// 初始化入会的设置
AliRTCLinuxEngine.JoinChannelConfig joinConfig = new AliRTCLinuxEngine.JoinChannelConfig();
// 关闭录制功能
joinConfig.recordingMode = AliRTCLinuxEngine.RecordingMode.RecordingManually;
// 关闭自动推流
joinConfig.publishMode = AliRTCLinuxEngine.PublishMode.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 + channelId + userId + nonce + timestamp)
gslb gslb 服务地址,该参数是数组类型,当前请使用:["https://****"],请您通过业务服务器下发到客户端 SDK,不建议您将该地址固化在客户端代码。
agent agent 服务地址,该参数是数组类型,当前请使用:["https://****"],请您通过业务服务器下发到客户端 SDK,不建议您将该地址固化在客户端代码。
  1. 发布或取消发布本地流。
  • 自动发布模式:加入频道成功后,即可发布本地流,无需再次调用 publish 接口。
  • 手动发布模式:加入频道成功后,可通过以下接口发布本地流。

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

// 开启Yuv输入,使用相机流进行推送
// 注意:第二个参数useTexture目前只能设置为false
linuxEngine.setExternalVideoSource(true, false, AliRTCLinuxEngine.VideoSource.VideoSourceCamera, AliRTCLinuxEngine.RenderMode.RenderModeAuto);
// 开启Pcm输入
// 第二个参数为pcm的采样率,请根据实际情况设置
// 第三个参数为pcm的channel数,请根据实际情况设置
linuxEngine.setExternalAudioSource(true, 16000, 2);

如果发布过程中需要变更配置或者停止发布,需要按如下流程先重新设置配置参数,然后再调用 publish 接口。

// 设置是否推相机流。true表示允许发布相机流,false表示不允许。
linuxEngine.configLocalCameraPublish(true);
// 设置是否推音频流。true表示允许发布音频流,false表示不允许。
linuxEngine.configLocalAudioPublish(true);
//设置是否推屏幕流。true表示允许发布屏幕流,false表示不允许。
linuxEngine.configLocalScreenPublish(true);
//设置是否推次要视频流。true表示允许发布次要视频流,false表示不允许。
linuxEngine.configLocalSimulcast(true);
linuxEngine.publish();
while (true) {
    ...
    // 推Yuv数据
    linuxEngine.pushExternalVideoFrame(sample, AliRTCLinuxEngine.VideoSource.VideoSourceCamera);
    // 推Pcm数据
    linuxEngine.pushExternalAudioFrameRawData(buf, frame_length, 0);
}

取消发布本地流。

// 设置是否推相机流。
linuxEngine.configLocalCameraPublish(false);
// 设置是否推音频流
linuxEngine.configLocalAudioPublish(false);
// 设置是否推屏幕流
linuxEngine.configLocalScreenPublish(false);
// 设置是否推次要视频流。
linuxEngine.configLocalSimulcast(false, VideoTrackCamera);
linuxEngine.publish();

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

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

开始录制。

linuxEngine.startRecording();

取消录制。

linuxEngine.stopRecording();

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

/**
* @brief 远端用户上线回调
* @param uid 远端用户ID
*/
void onRemoteUserOnLineNotify(String uid);
/**
* @brief 远端用户下线回调
* @param uid 远端用户ID
*/
void onRemoteUserOffLineNotify(String uid);
/**
* @brief 音频原始数据的回调
* @param frame 音频原始数据
*/
void onAudioFrameReceived(AliRTCLinuxEngine.AudioFrame frame);
/**
* @brief 视频原始数据的回调
* @param uid 远端用户ID,
* @param frame 视频原始数据
*/
void onVideoFrameReceived(String uid, AliRTCLinuxEngine.VideoFrame frame);
  1. 离开频道。
linuxEngine.eaveChannel();
  1. 销毁 SDK。
linuxEngine.destroy();
linuxEngine = null;

接口详情请参见 AliRtcEngine 接口


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

image.png

相关文章
|
25天前
|
安全 Java 测试技术
🎉Java零基础:全面解析枚举的强大功能
【10月更文挑战第19天】本文收录于「滚雪球学Java」专栏,专业攻坚指数级提升,希望能够助你一臂之力,帮你早日登顶实现财富自由🚀;同时,欢迎大家关注&&收藏&&订阅!持续更新中,up!up!up!!
103 60
|
13天前
|
Java
Java 8 引入的 Streams 功能强大,提供了一种简洁高效的处理数据集合的方式
Java 8 引入的 Streams 功能强大,提供了一种简洁高效的处理数据集合的方式。本文介绍了 Streams 的基本概念和使用方法,包括创建 Streams、中间操作和终端操作,并通过多个案例详细解析了过滤、映射、归并、排序、分组和并行处理等操作,帮助读者更好地理解和掌握这一重要特性。
23 2
|
1月前
|
算法 Java Linux
java制作海报七:java Graphics2D 合成图片 在 linux下中文不显示,echarts图上的中文也不显示问题
这篇文章讨论了在Linux环境下使用Java Graphics2D合成图片时遇到的中文显示问题,并提供了解决方案,包括如何在Linux系统中添加中文字体库。
35 1
java制作海报七:java Graphics2D 合成图片 在 linux下中文不显示,echarts图上的中文也不显示问题
|
1月前
|
Java 程序员
在Java编程中,关键字不仅是简单的词汇,更是赋予代码强大功能的“魔法咒语”。
【10月更文挑战第13天】在Java编程中,关键字不仅是简单的词汇,更是赋予代码强大功能的“魔法咒语”。本文介绍了Java关键字的基本概念及其重要性,并通过定义类和对象、控制流程、访问修饰符等示例,展示了关键字的实际应用。掌握这些关键字,是成为优秀Java程序员的基础。
24 3
|
1月前
|
Java Linux
java读取linux服务器下某文档的内容
java读取linux服务器下某文档的内容
38 3
java读取linux服务器下某文档的内容
|
1月前
|
Java 数据安全/隐私保护
Java ffmpeg 实现视频加文字/图片水印功能
【10月更文挑战第22天】在 Java 中使用 FFmpeg 实现视频加文字或图片水印功能,需先安装 FFmpeg 并添加依赖(如 JavaCV)。通过构建 FFmpeg 命令行参数,使用 `drawtext` 滤镜添加文字水印,或使用 `overlay` 滤镜添加图片水印。示例代码展示了如何使用 JavaCV 实现文字水印。
|
1月前
|
Java
java实现从HDFS上下载文件及文件夹的功能,以流形式输出,便于用户自定义保存任何路径下
java实现从HDFS上下载文件及文件夹的功能,以流形式输出,便于用户自定义保存任何路径下
58 2
java实现从HDFS上下载文件及文件夹的功能,以流形式输出,便于用户自定义保存任何路径下
|
1月前
|
机器学习/深度学习 算法 Java
通过 Java Vector API 利用 SIMD 的强大功能
通过 Java Vector API 利用 SIMD 的强大功能
44 10
|
1月前
|
Oracle 安全 Java
Java 22 为开发人员带来了重大增强功能
Java 22 为开发人员带来了重大增强功能
39 9
|
1月前
|
Java
让星星⭐月亮告诉你,jdk1.8 Java函数式编程示例:Lambda函数/方法引用/4种内建函数式接口(功能性-/消费型/供给型/断言型)
本示例展示了Java中函数式接口的使用,包括自定义和内置的函数式接口。通过方法引用,实现对字符串操作如转换大写、数值转换等,并演示了Function、Consumer、Supplier及Predicate四种主要内置函数式接口的应用。
27 1
下一篇
无影云桌面