本文档将介绍如何快速跑通ARTC Linux SDK Golang版本示例项目,体验实时音视频功能。
示例源码获取
在SDK下载中获取最新版本的ARTC Linux SDK。解压Linux SDK压缩包,打开解压后的文件夹里面的Go文件夹,交付产物包括如下:
artc_linux_go/
├── alirtc
│ ├── AliRTCEngine.go
│ ├── AliRTCEngineImpl.go
│ ├── AliRTCLinuxSdkDefine.go
│ ├── go.mod
│ └── lib
│ ├── AliRtcCoreService
│ ├── libAliRtcLinuxEngine.so
│ └── libonnxruntime.so.1.16.3
├── demo.go
├── go.mod
└── README.mdalirtc目录包含需要链接的SDK动态库(lib),以及对应的Go接口封装,从而通过Go代码实现与C++接口一致的RTC推拉流功能。
demo.go提供简易例程,需要将ALIRTC_APPID、ALIRTC_APPKEY、LIBPATH替换以执行。
前提条件
在运行示例项目之前,请确保满足以下要求
请确保您的Linux内核版本在2.6以上,且Go运行时为1.22.5及以上版本。若您希望基于C++接口进行额外开发,还需确保GCC版本在4.8以上。
应用准备:获取实时音视频应用的AppID和AppKey,详情请参考获取开发参数。
操作步骤
配置示例项目
启动终端,进入 Go目录,修改demo.go ,配置您的APPID和APPKEY,并指定AliRtcCoreService的路径。
APPID和APPKEY需要在创建应用后从控制台获取
AliRtcCoreService位于AliRTCSDK_Linux-7.10.2/Go/alirtc/lib/AliRtcCoreService。

运行Demo
请参考前提条件中的要求配置好Go语言环境。
直接在终端运行下面的命令即可运行示例Demo
go run demo.go若终端有以下输出,表示入会、推流成功。
# 入会成功
[Go] on join channel result. Channel: 123123, user: linux, result: 0
# 推流成功
[Go] on audio publish state changed, oldState: 0, newState: 2
[Go] on video publish state changed, oldState: 0, newState: 2
[Go] on audio publish state changed, oldState: 2, newState: 3
[Go] on video publish state changed, oldState: 2, newState: 3
# 远端用户web已上线
[Go] on remote user online: web
# 收到来自远端用户abcd的音视频流
[Go] on audio subscribe state of web, oldState: 0, newState: 2
[Go] on video subscribe state of web, oldState: 0, newState: 2
[Go] on audio subscribe state of web, oldState: 2, newState: 3
[Go] on video subscribe state of web, oldState: 2, newState: 3音频订阅选择AudioFormatMixedPcm模式时,无论是否有远端用户在会上,入会时就会有音频回调。选择AudioFormatPcmBeforMixing时,只有会上有其他用户,且其他用户在推音频流时,才会触发音频回调。
如果运行"go run demo.go"报错,删除当前目录下的go.mod文件和alirtc目录下的go.mod文件。cd到alirtc目录,执行"go mod init alirtc",然后cd到demo.go文件所在目录,依次执行"go mod init demo","go mod edit -replace alirtc=./alirtc","go mod tidy","go run demo.go"即可运行demo。