一、概述
本文档是深圳华云汇通科技有限公司SDK的说明使用手册,介绍了音视频、命令发送等的相关接口。SDK的使用不区分Android与iOS。本文档介绍Android开发者如何使用SDK。整体流程如下图:
(音视频流程图)
(消息透传流程图)
二、预备工作
1)、将SDK导入项目,如下图,so库放入jniLibs下的armeabi文件夹中,头文件放在jni文件夹下(本示例处于Android Studio开发环境中):
需注意:指定要ndk需要兼容的架构(这样其他依赖包里mips,x86,armeabi-v7a,arm-v8之类的so会被过滤掉),如下:
2)、添加用户权限:
如果需要使用音频功能,还需要配置:
三、使用说明
1、加载so库:
2、初始化SDK并且注册回调函数 InitXCloudLink()
3、用户登录服务器(优载云的账号、密码请发邮件至ali@youzaiyun.com进行申请)
* 登录前要先初始化和调用AddXCloudHost, LogIn和LogOut是成对出现
4、登录成功后请订阅以及认证设备(若是登录失败,请重新登录,可见 四-1 登录失败后的回调)。
若是认证失败,需要重新订阅(详情见 四-1 认证失败后的回调)
5、设备连接
请先判断设备是否连接,若是连接成功,可进行下一步,若是失败,则代表设备不在线。
6、音视频的操作以及消息透传的操作
1)、消息透传:
订阅成功并且认证成功后,才可以发送想要发送的消息:
2)、音视频连接
a、建立P2P连接
b、打开视频
打开成功后,开始接受音视频数据,此时可调用回调函数,请参看 四-2 音视频的回调
c、对音频进行处理后请关闭音频
9、退出登录
10、释放资源
四、回调函数的说明
1、消息回调
登录失败后会返回回调信息111。
认证失败后会返回回调信息126。
2、音视频回调
五、Constant类的说明介绍:
六、音视频相关功能参考
1、视频相关:
2、音频相关:
七、消息回调的参数说明:
例如:
八、注意事项:
1、当4G切换成WiFi或者WiFi切换成4G时,需要 退出(见 三-9) → 重新登录(见 三-3) 重复此套流程。
2、当订阅失败时,则代表想要订阅的设备的认证密码错误。
3、释放资源与初始化在整套流程中只需要出现一次,并且是以成对的形式出现。
九、点击可下载API文档说明