本文指导开发者在将 RTSA 集成到项目中之前,编译并运行模拟数据 Demo 对进行初步了解。
请确保开发环境满足以下要求:
请下载以下文件:
步骤如下:
进入 RTD_DATA_DEMO\bin 目录,将 bin\PLACEHOLDER 重命名为 bin\app_id_and_cert.h。
在 bin\app_id_and_cert.h 文件中填写你的 App ID。
如果启用了声网 License 机制,还需要填写 Certificate,用于绑定设备。详见声网 License 机制文档。
将 SDK 包中的 include 文件夹和 libagora-rtc-sdk.lib 复制到 lib 文件夹下,libagora-rtc-sdk.dll 复制到目标运行目录下(如 build/bin/Debug)。
创建 build 目录, 从 CMake 生成 VS 工程:
1). 填写 demo 目录和 build 文件夹目录如下:
2). 点击 Generate,在弹出的界面选择系统类型和 Visual Studio 版本。举例来说,如果你使用 Win10 64 位和 Visual Studio 17,可以选择 Visual Studio 15 2017 Win64。
3). 点击 Finish,CMake 将会在 build 目录下生成对应的 Visual Studio 工程,然后用 Visual Studio 打开编译即可。
编译成功后,会生成一个可执行程序 demo.exe,根据制定的编译类型,可能在 build\bin\Debug 或 buid\bin\Release 目录下。复制 libagora-rtc-sdk.dll 到该目录,即可运行 demo.exe。
打印帮助信息:
打开命令行 (cmd) 并进入 buid\bin\Release 或 buid\bin\Debug 目录中,运行如下命令打印帮助信息:
demo.exe --help
可以看到可配置的运行参数如下:
参数 | 描述 |
---|---|
app_id | App ID,项目的唯一标识。 |
cert [Optional] | Certificate for License,用于绑定 IoT 设备。 |
audio_bps [Optional] | 音频码率,int32 类型。 |
audio_fps [Optional] | 音频帧率,int32 类型。 |
channel [Optional] | 频道名,string 类型。 |
duration [Optional] | 频道时长(秒),int32 类型。 |
key_interval [Optional] | 关键帧间隔(毫秒),uint32 类型。 |
round [Optional] | Demo 运行的次数,uint32 类型。从加入频道到退出频道为一轮。 |
video_fps [Optional] | 视频帧率,int32 类型。 |
video_target_bps [Optional] | 视频目标码率,int32 类型。 |
verbose [Optional] | 啰嗦模式。启用该模式后会打印更多信息。 |
设置参数并运行:
demo.exe --channel hello_world_opps