声网提供了一个简单的示例项目 hello_rtsa.c
和 hello_rtm.c
用于演示推流、拉流和信令发送接收的基本功能。该示例项目位于 RTSA Lite SDK 包 example 目录中。
你可以先编译并运行示例项目体验功能,初步了解 RTSA Lite SDK 的 API 调用,以便后续能够更高效地将 RTSA Lite 集成到你自己的应用程序中。
一台开发机,可以是电脑或嵌入式设备。环境要求详见 SDK 概述。本文以安装 Ubuntu 18.04 系统的个人电脑为例。
参考开始使用声网平台获取以下信息:
demo_channel
。user1
和 user 2
分别获取 RTM Token。本文将获取的 RTM Token 分别指代为 RTM_TOKEN_1 和 RTM_TOKEN_2。参考开始使用声网平台获取以下信息:
如果你使用 SDK 包自带的许可证文件进行免费体验,可跳过此步骤。
本文以 x86_64 的包为例。你可以参考 下载页面 获取其他平台的包。
# 获取 SDK
wget https://download.agora.io/rtsasdk/release/Agora-RTSALite-RmAcAjCP-x86_64-linux-gnu-v1.9.0.tgz
# 解压缩
tar xvf Agora-RTSALite-RmAcAjCP-x86_64-linux-gnu-v1.9.0.tgz
获取 SDK 包,解压并在 SDK 包 example 目录下运行以下命令编译示例项目。
# 切换到示例项目目录
cd agora_rtc_sdk/example
# 构建示例项目
./build-86_64.sh
如果你需要在设备端(通常是 ARM Linux 系统)运行
hello_rtsa
,请先参考 SDK 包中的移植指南(PORTING.md
文件)。
编译完成后,会在当前目录下生成以下可执行文件:
hello_rtsa
hello_rtm
demo 自带的 License 仅供测试,试用时效为 90 天且存在 10 路并发限制。 如果你需要在生产环境使用 RTSA Lite SDK,请务必参考 License 使用指南购买并激活商用 License。
你可通过以下命令行,把 YOUR_APP_ID
替换成你获取的 App ID,把 MY_RTC_TOKEN
替换成你获取的 RTC 临时 Token,加入名为 demo_channel
的频道,并且用默认参数 开始发送发送 H.264 视频和 PCM 音频。音视频源默认为 SDK 包自带的 send_audio_16k_1ch.pcm
和 send_video.h264
文件。
cd out/x86_64
./hello_rtsa -i YOUR_APP_ID -c demo_channel --token MY_RTC_TOKEN
运行媒体流示例项目之后,你可以按如下步骤进行验证:
克隆 API-Examples-Web 到本地,在浏览器中打开 Demo/index.html
文件。
点击 basicvideocalling 下的 tryitnow,进入视频通话 demo 界面。
输入你的 App ID、RTC 临时 Token、频道名 demo_channel
及任意用户名,点击 join。成功加入频道后,你就可以看到和听到实时音视频流了。
打开两个终端,分别在两个终端输入如下命令行,实现两个终端之间互相发送消息。
YOUR_APP_ID
替换成你在第一步中获取到的 App ID。RTM_TOKEN_1
替换成你获取的 RTM_TOKEN_1。RTM_TOKEN_2
替换成你获取的 RTM_TOKEN_2。# 终端 1
cd out/x86_64
./hello_rtm --appId YOUR_APPID --rtmUid user1 --peerUid user2 --token RTM_TOKEN_1
# 终端 2
cd out/x86_64
./hello_rtm --appId YOUR_APPID --rtmUid user2 --peerUid user1 --token RTM_TOKEN_2