跳到主要内容

安卓版DeviceSDK说明

更新时间：2025-10-31 17:16:12

针对 Android 平台，DeviceSDK 通过 JNI 封装提供了 Java 接口，相比其他嵌入式版本更易于开发和集成。特别适用于带摄像头或屏幕的 Android 设备，可实现直播监控与双向视频对讲功能。

系统要求&环境配置​

安卓版DeviceSDK基于 NDK 版本android-ndk-r26b 进行编译，使用的安卓API接口为24版本，对外提供32位和64位动态共享库。

SDK打包目录结构​

和嵌入式DeviceSDK类似，安卓版DeviceSDK也分为IotSDK和StreamSDK两部分：

IotSDK 打包目录结构如下：

abs/
├── Bin
├── Demo
├── Docs
├── Include					//c版本头文件，安卓不需要，可以作为参考
│   ├── xs_base_type.h
│   ├── xs_iot_api.h
│   ├── xs_iot_datatypes.h
│   ├── xs_iot_error.h
│   └── xs_iot_server.h
└── Lib
    ├── android
    │   ├── arm64-v8a				//安卓64位IoTSDK 动态库
    │   │   └── libxsIotSdk.so		
    │   ├── armeabi-v7a				//安卓32位StreamSDK 动态库
    │   │   └── libxsIotSdk.so		
    │   ├── IotBindInfo.java		//结构体定义
    │   ├── IotCallbackFun.java		//回调API接口定义
    │   ├── IotDeviceInfo.java		//结构体定义
    │   ├── IotEventData.java		//结构体定义
    │   ├── IotInitParam.java		//结构体定义
    │   ├── IotResponse.java		//结构体定义
    │   ├── IotSDK.java				//对外API接口定义
    │   └── RtcxIotSDK.jar			//jar 包
    └── x64

StreamSDK打包目录结构如下：

abs/
├── Bin
├── Demo
├── Docs
├── Include				//c版本头文件，安卓不需要，可以作为参考
│   ├── xs_base_type.h
│   ├── xs_proxy_api.h
│   ├── xs_stream_api.h
│   ├── xs_stream_datatypes.h
│   └── xs_stream_error.h
└── Lib
    ├── android
    │   ├── arm64-v8a
    │   │   └── librtcx_streamsdk_jni.so	//安卓64位StreamSDK 动态库
    │   ├── armeabi-v7a
    │   │   └── librtcx_streamsdk_jni.so	//安卓64位StreamSDK 动态库
    │   ├── AudioEncodeParam.java			//结构体定义
    │   ├── AudioInfo.java					//结构体定义
    │   ├── DeviceAuth.java					//结构体定义
    │   ├── DeviceParams.java				//结构体定义
    │   ├── librtcx_streamsdk.jar			//jar 包
    │   ├── PictureInfo.java				//结构体定义
    │   ├── PushParams.java					//结构体定义
    │   ├── StreamCallbackFun.java			//回调API接口定义
    │   ├── StreamConfig.java				//结构体定义
    │   ├── StreamIndex.java				//结构体定义
    │   ├── StreamSDK.java					//对外API接口定义
    │   ├── VideoEncodeParam.java			//结构体定义
    │   └── VideoInfo.java					//结构体定义
    └── x64

接入说明​

目前安卓版支持的功能比较简单，主要包含绑定、解绑、直播、双向视频对讲等基础功能。

JAVA接口API名称和C接口API接口名称一致，因此本章节对API接入流程不做赘述，详细接入流程可以参考普通IPC接入说明: IoTSDK接入 和 StreamSDK接入

针对设备启动、直播推流、视频对讲功能，主要流程如下：

启动流程：

图片无法显示

直播推流：

图片无法显示

双向视频对讲：

图片无法显示

另外，相速会提供安卓版DeviceSDK Demo程序源码（指导如何接入安卓版DeviceSDK），可以在手机端直接运行，和Android DemoApp可以进行双向视频对讲，效果如下图所示：

图片无法显示

代码获取​

Android DeviceSDK和Android DeviceSDK Demo对接群咨询