智汇云-企业数智化核心引擎

首页> 开发者中心>SDK管理>IoT SDK>Android>开发文档

## 开发文档

### Android IoT SDK简单介绍

智汇云以SDK形式提供物联网视频服务（含物联网视频采集、上传、播放、RTC通话、本地缓存等），帮助开发者快速实现视频实时监控、历史回看、多人多方对讲、文件上传、预缓存等功能。

IoT SDK包含jar包、demo及开发文档。

### 功能说明

系统属性
 - Android 4.0及以上
 - CPU armeabi-v7a架构（同时兼容armeabi、arm64-v8a、x86、x86_64）

功能列表
 - 观看设备直播/卡录
 - 语音通话
 - 设备文件下载

### SDK集成

#### 下载SDK

sdk下载链接：[https://zyun.360.cn/developer](https://zyun.360.cn/developer)

- jar
    - qhvc_tools_sdk.jar
    - qhvc_net_sdk.jar
    - qhvc_interactive_sdk.jar

- so
    - armeabi-v7a/libqhvc_breakpad.so
    - armeabi-v7a/libtranscore.so
    - armeabi-v7a/liblocalserver.so
    - armeabi-v7a/libagora-rtc-sdk-jni.so
    - armeabi-v7a/libapm-agora-plugin.so
    - armeabi-v7a/libzegoavkit.so

| 文件 | 说明    | 注意事项  | 参考文档
| ------- | ----------- | ------------ | ------------ |
| qhvc_tools_sdk.jar libqhvc_breakpad.so libtranscore.so| 公共库 | 必须导入 |
| qhvc_net_sdk.jar liblocalserver.so| 帝视库 |  必须导入 |
| qhvc_interactive_sdk.jar libagora-rtc-sdk-jni.so libapm-agora-plugin.so libzegoavkit.so | 语音通话库 | 使用语音通话时，必须导入 | 请参考互动直播文档

demo下载链接：[https://github.com/360livecloud/android_demo.git](https://github.com/360livecloud/android_demo.git)

#### 配置说明

将*.jar放到工程libs目录下，在build.gradle中配置：
```
dependencies {
    compile fileTree(include: ['*.jar'], dir: 'libs')
}
```

将*.so放到工程src/main/jniLibs/armeabi-v7a/目录下，在build.gradle中配置：
```
android {
    defaultConfig {
        ndk {
            // 设置支持的CPU架构，目前只支持armeabi-v7a架构（该架构兼容armeabi、arm64-v8a、x86、x86_64架构）
            abiFilters 'armeabi-v7a'
        }

}
}
```

#### 权限配置

```
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
```

#### 混淆规则

```
-keep class com.qihoo.livecloud.** {
    <fields>;
    <methods>;
}

-keep class com.qihoo.videocloud.** {
    <fields>;
    <methods>;
}

-keep class net.qihoo.videocloud.** {
    <fields>;
    <methods>;
}
```

#### 调试

为便于接入时定位问题，可以在开发版本中打开logcat日志，本地缓存相关的日志TAG为GodSees。

```
/**
 * 设置日志级别, 日志会直接打印到logcat, Tag为 QHVCNet。该接口可以在SDK初始化前调用
 *
 * @param logLevel 日志级别, 取值{@link #LOG_NONE}, {@link #LOG_FATAL}, {@link #LOG_WARN}, {@link #LOG_INFO}, {@link #LOG_DEBUG}
 */
QHVCNet.setLogLevel(int logLevel);
```

#### 接入流程

#### SDK初始化

需要调用`QHVCSdk.getInstance().init()`，接口说明如下：

appId(也叫businessId)是为业务分配的业务ID（appId获取地址：登录[视频云官网](https://zyun.360.cn/)-控制台-SDK-应用管理-新建应用）【见下图】；version为业务端APP的版本号；machineId为设备唯一标识；uid为业务方用户标识，只要保证唯一即可。

![创建AppId截图](http://p5.qhimg.com/t011da35ea7b6063845.png)

[点此查看应用ID](https://zyun.360.cn/console/sdk/application)

> 对appId和channelID这两个参数的引入，在设计之初目的是为了每个业务有独立的ID，通过appId来获取云端的一些参数控制，特别是视频缓冲策略、P2P行为、硬解码黑白名单以及解码库类型；channelID更多的为数据统计打点的唯一标注，可以通过云点播和云直播的服务标识来获取，以此获取播放数据反馈。UserID的设计是为了业务方和视频云唯一的沟通桥梁，只要保持唯一即可，一般为用户ID的加密字符串，通过UserID可以排查到一个用户的级别的失败日志；

```
QHVCSdkConfig.Builder builder = new QHVCSdkConfig.Builder(this)
        .setAppId("businessId")
        .setAppVersion("version")
        .setMachineId("machineId")
        .setUserId("uid");

QHVCSdk.getInstance().init(builder.build());

```

#### APPID合法性验证

需要调用 `public int validityCheck(String appId, String authorization, long authTime, int randomNum, final QHVCAppAuth.ResultCallback<String> callback)`，接口说明如下：

合法性验证需要用到appId, Access Key(简称AK)和Secret Key(简称SK)。AK、SK获取地址： 登录[视频云官网](https://zyun.360.cn/)-用户中心-秘钥管理【见下图】。
只有appId、Access Key以及Secret Key相匹配，才能通过鉴权，否则将无法正常使用SDK。

![秘钥获取](http://p2.qhimg.com/t0146c3d44e71ae7a62.png)

[点此查看秘钥](https://zyun.360.cn/console/usercenter/accesskey)

==注意：此接口必须在启动APP后120秒内调用，否则将无法正常使用SDK。==

appId使用和SDK初始化时同样的内容，callback可以用来监听合法性验证结果。 计算authorization时需要使用AK、SK以及当前系统的时间戳和随机数。
**为了保证AK、SK的安全，请业务接入时，务必把AK和SK存储在服务端，并且把authorization的计算也放在服务端来做。**

计算authorization的示例代码如下：

```
    private void videocloudValidCheck() {
        int randomNum = new Random(100000000).nextInt(); //随机数
        long authTime = System.currentTimeMillis() / 1000; //时间戳 (unix时间戳（10位）)

//TODO 为了保证ak、sk的安全，请业务接入时，务必把AK和SK存储在服务端，并且把authorization的计算也放在服务端来做。
        String authorization = getServerAuthorization(appId, AK, SK, randomNum, authTime);

QHVCSdk.getInstance().validityCheck(appId, authorization, authTime, randomNum, new QHVCAppAuth.ResultCallback<String>() {

@Override
            public void onSuccess(String data) {
                Logger.i(TAG, "validityCheck onSuccess, data: " + data);
            }

@Override
            public void onFailed(int errCode, String errMsg) {
                Logger.e(TAG, "validityCheck onFailed, errCode: " + errCode + ", errMsg: " + errMsg);
            }
        });
    }

private String getServerAuthorization(String appID, String ak, String sk, int randNum, long authTime) {
        HashMap<String, String> mapParams = new HashMap<>();
        mapParams.put("appid", appID);

String strParams = getParams(mapParams);
        String paramSign = makeParamSign(strParams, randNum);
        String authString = ak + "\n" + authTime + "\n" + randNum + "\n" + paramSign;
        String encryptString = null;
        try {
            encryptString = encryptHMAC(authString, sk);
        } catch (Exception e) {
            e.printStackTrace();
        }
        Logger.i(TAG, "apiAuth(), encryptString: " + encryptString);
        return ak + ":" + encryptString;
    }

private String getParams(Map<String, String> mapParams) {
        String strParams;
        if (mapParams == null || mapParams.isEmpty()) {
            strParams = "";
        } else {
            StringBuilder sbParams = new StringBuilder();
            Object[] key_arr = mapParams.keySet().toArray();
            Arrays.sort(key_arr);/*key升序排列*/
            for (Object key : key_arr) {
                String value = mapParams.get(key);
                if (!TextUtils.isEmpty(value)) {
                    sbParams.append("&").append(key).append("=").append(value);
                }
            }
            strParams = sbParams.substring(1);
        }
        return strParams;
    }

private String makeParamSign(String param, int randNum) {
        return MD5.encryptMD5(MD5.encryptMD5(param) + randNum);
    }

public String encryptHMAC(String data, String key) throws Exception {
        final String KEY_MAC = "HmacSHA1";
        SecretKey secretKey = new SecretKeySpec(key.getBytes(), KEY_MAC);
        Mac mac = Mac.getInstance(KEY_MAC);
        mac.init(secretKey);
        byte[] rawHmac = mac.doFinal(data.getBytes());
        return Base64.encodeToString(rawHmac, Base64.DEFAULT);
    }
```

相关错误码：

```
int AUTH_OK = 1;                  //鉴权成功
int AUTH_FAILED = -11001;         //鉴权未通过（鉴权失败）
int AUTH_NOT_INVOKED = -11002;    //未调用鉴权接口
```

##### Net初始化/销毁
在使⽤用QHVCNet的功能前，需要先开启本地服务。启动⽅方法全局调⽤用⼀一次即可。

```
/**
 * 初始化QHVCNet，全局只用调用一次，需要和{@link #stopLocalServer}配对使用
 *
 * @param context    context
 * @param cacheDir   缓存目录，要保证是一个当前存在且有读写权限的文件夹
 * @param deviceId   设备Id，统计上报会带上，追查问题用
 * @param businessId 业务ID
 * @param params     可选参数，可传空。参数列表：<br>
 *                   {@link #QHVC_NET_PARAM_CACHE_SIZE} 缓存占用空间大小，单位MB
 *                   {@link #QHVC_NET_PARAM_FORCE_P2P}  是否强制p2p  数据类型: Boolean
 *                   {@link #QHVC_NET_PARAM_CHANNEL_ID} channelId  数据类型: String    [当开启p2p时，必须设置]
 * @return true 初始化成功；false 初始化失败
 */
public static boolean startLocalServer(Context context, String cacheDir, String deviceId, String businessId, Map<String, Object> params);
```

其中，可选参数列表如下：

参数 | 说明 | 备注
---|---|--
QHVCNet.QHVC_NET_PARAM_CACHE_SIZE | 缓存占用空间大小，单位MB | 如果调用`QHVCNet.setCacheSize(int)`修改默认缓存占用空间大小，必须在初始化时也设置一次
QHVCNet.QHVC_NET_PARAM_FORCE_P2P  | 是否强制p2p  数据类型: Boolean |
QHVCNet.QHVC_NET_PARAM_CHANNEL_ID | channelId  数据类型: String | 当开启p2p时，必须设置

调用`QHVCNet.startLocalServer()`必须配对调用`QHVCNet.stopLocalServer()`：

```
/**
 * 销毁QHVCNet，需要和{@link #startLocalServer}配对使用
 */
QHVCNet.stopLocalServer();
```

#### 看设备直播

##### 观看直播的整体流程如下:
1. 更新秘钥
2. 创建session
3. 获取播放地址, 创建播放器播放
4. 传送业务Token给设备验证
5. 监听事件回调

下⾯面详细介绍下流程中需要调⽤用的API和相关操作。

###### 更新秘钥
定时更新加密秘钥，用于加密视频数据
```
QHVCNetGodSees.updateGodSeesStreamKeys(String serialNumber, int[] keys, String[] values)}
```
###### 创建session
###### 获取播放地址, 创建播放器播放
```
String sessionId = createSessionId();
int ret = QHVCNetGodSees.createGodSeesSession(sessionId, serialNumber, 1, QHVCNetGodSees.QHVC_NET_GODSEES_PLAY_TYPE_LIVE);
if (ret) {
 String url = QHVCNetGodSees.getGodSeesPlayUrl(sessionId);
 if (!TextUtils.isEmpty(url)) {
     playUrl = url;
     startPlayerForLive();
 }
}
```

###### 传送业务Token给设备验证
```
QHVCNetGodSees.setOnGodSeesVerifyTokenListener(new QHVCNetGodSees.OnGodSeesVerifyTokenListener() {
 public void onGodSeesVerifyToken(String sessionId, int result) {
     if (result == 0) {
          //设备校验成功，设备开始发送数据
     }
 }
});
```

###### 监听事件回调

```
QHVCNetGodSees.setOnGodSeesErrorListener(...)
```
###### 借用业务长连通道，发送sdk信令信息(用于p2p不通时，切换转发模式)
```
QHVCNetGodSees.setOnGodSeesSignallingSendDataListener(new QHVCNetGodSees.OnGodSeesSignallingSendDataListener() {
 public int onGodSeesSignallingSendData(String destId, String data) {
     xxxSendingMessage(data);
 }
});

#### 初始化播放器
具体请参考播放器sdk
[https://live.360.cn/index/sdkdownload](https://live.360.cn/index/sdkdownload)

```
private void startPlayerForLive(){
 ...
 Map<String, Object> options = new HashMap<>();
 options.put(IQHVCPlayerAdvanced.KEY_OPTION_PLAY_MODE, IQHVCPlayerAdvanced.PLAYMODE_LOWLATENCY);
 options.put(IQHVCPlayerAdvanced.KEY_OPTION_SESSION_ID, sessionId);//注意: 和QHVCNetGodSees.createGodSeesSession使用相同的sessionId
 qhvcPlayer.setDataSource(IQHVCPlayer.PLAYTYPE_LIVE, playUrl, channelId, "", options);

qhvcPlayer.setOnPreparedListener(new IQHVCPlayer.OnPreparedListener() {
     public void onPrepared() {
         int ret = QHVCNetGodSees.sendGodSeesBusinessTokenToDevice(sessionId, token);
         if (ret) {
             qhvcPlayer.start();
         }
     }
 }
 ...
}
```

###### 关闭

```
播放器(QHVCPlayer)关闭

QHVCNetGodSees.destroyGodSeesSession(sessionId);
QHVCNetGodSees.setOnGodSeesVerifyTokenListener(null);
QHVCNetGodSees.setOnGodSeesSignallingSendDataListener(null);
QHVCNetGodSees.setOnGodSeesErrorListener(null);
```

#### 看设备卡录

##### 观看卡录的整体流程如下:
1. 更新秘钥
2. 创建session
3. 获取播放地址, 创建播放器播放
4. 传送业务Token给设备验证
5. 获取卡录时间轴信息
6. 设置播放位置
7. 监听事件回调

下⾯面详细介绍下流程中需要调⽤用的API和相关操作。

###### 更新秘钥
 ```
// 定时更新加密秘钥，用于加密视频数据
QHVCNetGodSees.updateGodSeesStreamKeys(String serialNumber, int[] keys, String[] values)}
```

###### 创建session
###### 获取播放地址, 创建播放器播放
###### 传送业务Token给设备验证
```
String sessionId = createSessionId();
int ret = QHVCNetGodSees.createGodSeesSession(sessionId, serialNumber, 1, QHVCNetGodSees.QHVC_NET_GODSEES_PLAY_TYPE_RECORD);
 if (ret) {
     String url = QHVCNetGodSees.getGodSeesPlayUrl(sessionId);
     if (!TextUtils.isEmpty(url)) {
         playUrl = url;

startPlayerForCardRecord();
         int tokenRet = QHVCNetGodSees.sendGodSeesBusinessTokenToDevice(sessionId, token);
         if (tokenRet) {

}
     }
 }
```

###### 获取卡录时间轴信息
```
QHVCNetGodSees.setOnGodSeesVerifyTokenListener(new QHVCNetGodSees.OnGodSeesVerifyTokenListener() {
     public void onGodSeesVerifyToken(String sessionId, int result) {
         if (result == 0) {
              //设备校验成功
              if (!TextUtils.isEmpty(playUrl)) {

int ret = QHVCNetGodSees.getGodSeesRecordTimeline(sessionId);
                  if (ret) {

}
              }
         }
     }
 });
```

##### 设置播放位置
```
QHVCNetGodSees.setOnGodSeesRecordTimelineListener(new QHVCNetGodSees.OnGodSeesRecordTimelineListener() {
     public void onGodSeesRecordTimeline(String sessionId, RecordTimeline[] data) {
         // 卡录时间轴数据回调
         if (data != null && data.length > 0) {
             boolean ret = QHVCNetGodSees.seekGodSeesRecord(sessionId, data[0].getStart());
             if (ret) {
                 // 当收到setOnGodSeesSeekCompleteListener消息时，设备开始发送数据
             }
         }
     }
 });
```
##### 监听事件回调
```
QHVCNetGodSees.setOnGodSeesRecordUpdateCurrentTimestampListener(new QHVCNetGodSees.OnGodSeesRecordUpdateCurrentTimestampListener() {
     public void onGodSeesRecordUpdateCurrentTimestamp(String sessionId, long param1) {
         // 卡录播放时间进度
     }
 });
 QHVCNetGodSees.setOnGodSeesSeekCompleteListener(...);
 QHVCNetGodSees.setOnGodSeesRecordPlaybackRateListener(...);
 QHVCNetGodSees.setOnGodSeesRecordPlayCompleteListener(...);
 QHVCNetGodSees.setOnGodSeesErrorListener(...)
```

##### 借用业务长连通道，发送sdk信令信息(用于p2p不通时，切换转发模式)
```
QHVCNetGodSees.setOnGodSeesSignallingSendDataListener(new QHVCNetGodSees.OnGodSeesSignallingSendDataListener() {
     public int onGodSeesSignallingSendData(String destId, String data) {
         xxxSendingMessage(data);
     }
 });

// 收到sdk信令消息，回调给sdk
 XXXLongLive.setOnArrivedMessageListener(new XXXLongLive.OnArrivedMessageListener() {
     public void onArrivedMessage(String msg) {
         if (是sdk信令消息){
             QHVCNetGodSees.receiveGodSeesSignallingData(data);
         }
     }
 });
```
#### 初始化播放器
具体请参考播放器sdk
[https://live.360.cn/index/sdkdownload](https://live.360.cn/index/sdkdownload)

```
private void startPlayerForCardRecord(final long seekPos){
     ...
     Map<String, Object> options = new HashMap<>();
     options.put(IQHVCPlayerAdvanced.KEY_OPTION_PLAY_MODE, IQHVCPlayerAdvanced.PLAYMODE_FLUENCY);
     options.put(IQHVCPlayerAdvanced.KEY_OPTION_SESSION_ID, sessionId);//注意: 和QHVCNetGodSees.createGodSeesSession使用相同的sessionId
     qhvcPlayer.setDataSource(IQHVCPlayer.PLAYTYPE_LIVE, playUrl, channelId, "", options);
     ...
 }

}
 ```
##### 关闭
```
播放器(QHVCPlayer)关闭

QHVCNetGodSees.destroyGodSeesSession(sessionId);
QHVCNetGodSees.setOnGodSeesVerifyTokenListener(null);
QHVCNetGodSees.setOnGodSeesRecordTimelineListener(null);
QHVCNetGodSees.setOnGodSeesSeekCompleteListener(null);
QHVCNetGodSees.setOnGodSeesRecordPlaybackRateListener(null);
QHVCNetGodSees.setOnGodSeesSignallingSendDataListener(null);
QHVCNetGodSees.setOnGodSeesRecordPlayCompleteListener(null);
QHVCNetGodSees.setOnGodSeesErrorListener(null);

QHVCNetGodSees.stopLocalServer();
```

#### 主要接口
具体请参考javadoc

```
 /**
     * 设置业务token验证结果回调
     *
     * @param listener
     */
    public static synchronized void setOnGodSeesVerifyTokenListener(OnGodSeesVerifyTokenListener listener);
    
    /**
     * 设置卡录时间轴结果回调
     *
     * @param listener
     */
    public static synchronized void setOnGodSeesRecordTimelineListener(OnGodSeesRecordTimelineListener listener) 
    
    /**
     * 设置当前播放的卡录时间点回调
     *
     * @param listener
     */
    public static synchronized void setOnGodSeesRecordUpdateCurrentTimestampListener(OnGodSeesRecordUpdateCurrentTimestampListener listener)
    
    /**
     * 设置seek执行完成监听
     * <p>
     * 与{@link #seekGodSeesRecord}调用， 不是一一匹配的。 eg: 调用{@link #seekGodSeesRecord}多次，只返回一次{@link OnGodSeesSeekCompleteListener#onGodSeesSeekComplete}
     *
     * @param listener
     */
    public static synchronized void setOnGodSeesSeekCompleteListener(OnGodSeesSeekCompleteListener listener)
    
    
    /**
     * 设置倍速执行完成回调
     * <p>
     * 与{@link #setGodSeesRecordPlayRate}调用， 不是一一匹配的。 eg: 调用{@link #setGodSeesRecordPlayRate}多次，只返回一次{@link OnGodSeesRecordPlaybackRateListener#onGodSeesRecordPlaybackRate}
     *
     * @param listener
     */
    public static synchronized void setOnGodSeesRecordPlaybackRateListener(OnGodSeesRecordPlaybackRateListener listener)
    
     /**
     * 设置卡录播放完毕回调
     *
     * @param listener
     */
    public static synchronized void setOnGodSeesRecordPlayCompleteListener(OnGodSeesRecordPlayCompleteListener listener) 
    
     /**
     * 设置错误回调
     *
     * @param listener
     */
    public static synchronized void setOnGodSeesErrorListener(OnGodSeesErrorListener listener)
    
    /**
     * 设置发送信令功能接口
     *
     * @param listener
     */
    public static synchronized void setOnGodSeesSignallingSendDataListener(OnGodSeesSignallingSendDataListener listener) 
    
     /**
     * 初始化QHVCNet，全局只用调用一次，需要和{@link #stopLocalServer}配对使用
     *
     * @param context    context
     * @param cacheDir   缓存目录，要保证是一个当前存在且有读写权限的文件夹
     * @param deviceId   设备Id，统计上报会带上，追查问题用
     * @param businessId 业务ID
     * @param params     可选参数，可传空。参数列表：<br>
     *                   {@link #QHVC_NET_PARAM_CACHE_SIZE} 缓存占用空间大小，单位MB
     * @return true 初始化成功；false 初始化失败
     */
    @SuppressWarnings("ResultOfMethodCallIgnored")
    public static synchronized boolean startLocalServer(Context context, String cacheDir, String deviceId, String businessId, Map<String, Object> params)
    
      /**
     * 销毁QHVCNet，需要和{@link #startLocalServer}配对使用
     */
    public static synchronized void stopLocalServer() 
    
     /**
     * 帝视创建网络会话实例
     *
     * @param sessionId           实例会话ID
     * @param serialNumber        设备唯一标识
     * @param deviceChannelNumber 设备管道号，从索引1开始[1, ...]
     * @param playType            播放类型{@link QHVCNetGodSeesPlayType}
     * @return true 成功；false: 失败
     */
    @CheckResult
    public static boolean createGodSeesSession(@NonNull String sessionId, @NonNull String serialNumber, int deviceChannelNumber, @QHVCNetGodSeesPlayType int playType) 
    
      /**
     * 销毁网络会话实例
     *
     * @param sessionId 实例会话ID
     * @return true 成功；false: 失败
     */
    public static boolean destroyGodSeesSession(@NonNull String sessionId) 
    
    /**
     * 传输业务token给设备验证
     *
     * @param sessionId 实例会话ID
     * @param token     验证信息，字符串长度不能超过63个字符
     * @return true 成功；false: 失败
     */
    @CheckResult
    public static boolean sendGodSeesBusinessTokenToDevice(@NonNull String sessionId, @Size(min = 0, max = 63) String token)
    
     /**
     * 获取帝视指定会话播放的链接
     *
     * @param sessionId 实例会话ID
     * @return 返回帝视播放的链接，不成功将会返回空
     */
    @CheckResult
    public static String getGodSeesPlayUrl(@NonNull String sessionId) 
    
    
    /**
     * 禁止/允许p2p网络
     *
     * @param enable true:允许  false:禁止  默认:允许
     * @return true 成功；false: 失败
     */
    public static synchronized boolean enableGodSeesP2P(boolean enable)
    
     /**
     * 获取卡录时间轴信息(当调用{@link #sendGodSeesBusinessTokenToDevice}函数通知设备验证token成功后，才能调用此接口)
     *
     * @param sessionId 实例会话ID
     * @return true 成功；false: 失败
     */
    @CheckResult
    public static boolean getGodSeesRecordTimeline(@NonNull String sessionId)
    
     /**
     * 观看从指定位置之后的卡录(当调用{@link #sendGodSeesBusinessTokenToDevice}函数通知设备验证token成功后，才能调用此接口)
     *
     * @param sessionId     实例会话ID
     * @param timeStampByMS 指定时间点（单位：毫秒）
     * @return true 成功；false: 失败
     */
    @CheckResult
    public static boolean seekGodSeesRecord(@NonNull String sessionId, long timeStampByMS) 
    
     /**
     * 暂停观看卡录(当调用{@link #sendGodSeesBusinessTokenToDevice}函数通知设备验证token成功后，才能调用此接口)
     *
     * @param sessionId 实例会话ID
     * @return true 成功；false: 失败
     */
    @CheckResult
    public static boolean pauseGodSeesRecord(@NonNull String sessionId)
    
     /**
     * 恢复观看卡录(当调用{@link #sendGodSeesBusinessTokenToDevice}函数通知设备验证token成功后，才能调用此接口)
     *
     * @param sessionId 实例会话ID
     * @return true 成功；false: 失败
     */
    @CheckResult
    public static boolean resumeGodSeesRecord(@NonNull String sessionId) 
    
     /**
     * 恢复观看卡录(当调用{@link #sendGodSeesBusinessTokenToDevice}函数通知设备验证token成功后，才能调用此接口)
     *
     * @param sessionId 实例会话ID
     * @return true 成功；false: 失败
     */
    @CheckResult
    public static boolean resumeGodSeesRecord(@NonNull String sessionId) 
    
     /**
     * 帝视接收信令数据 (当调用{@link #sendGodSeesBusinessTokenToDevice}函数通知设备验证token成功后，才能调用此接口)
     *
     * @param msg 信令数据
     * @return true 成功；false: 失败
     */
    public static synchronized boolean receiveGodSeesSignallingData(String msg) 
    
    
    /**
     * 预连接设备 (当调用{@link #sendGodSeesBusinessTokenToDevice}函数通知设备验证token成功后，才能调用此接口)
     *
     * @param serialNumber        设备唯一标识
     * @param deviceChannelNumber 设备管道号，从索引1开始[1, ...]
     * @return true 成功；false: 失败
     */
    public static synchronized boolean preConnectGodSeesDevice(String serialNumber, int deviceChannelNumber)
    
    /**
     * 更新视频流解密秘钥（keys与values 一一对应）(当调用{@link #sendGodSeesBusinessTokenToDevice}函数通知设备验证token成功后，才能调用此接口)
     *
     * @param serialNumber 设备唯一标识
     * @param keys         秘钥keys    eg: [key0, key1, key2...]
     * @param values       秘钥values  eg: [value0, value1, value2...]
     * @return true 成功；false: 失败
     */
    public static boolean updateGodSeesStreamKeys(String serialNumber, int[] keys, String[] values)
    
       /**
     * 解密媒体数据。原地解密数据
     *
     * @param secretKey 解密秘钥
     * @param nativePlayerCtx native player context
     * @param nativePlayerPkt native media packet
     * @return
     */
    public static int decryptGodSeesMediaData(String secretKey, int nativePlayerCtx, int nativePlayerPkt)
    
    
    /**
     * 设置是否监控视频状态
     * @param isOpen true: 监控 false:不监控  默认不监控
     */
    public static void setMonitorVideoState(boolean isOpen)
    
    /**
     * @brief 获取设备文件下载的链接
     * @param fileKey 指定设备上的文件的标识符
     * @param serialNumber 设备唯一标识
     * @param token 待设备验证的标识，字符串长度不能超过63个字符
     * @param rangeStart 请求文件内容的起始位置，与http的range语义相同
     * @param rangeEnd 请求文件内容的结束位置，与http的range语义相同
     * @return 返回设备文件下载链接，不成功将会返回空
     */
    @CheckResult
    public static String getDeviceFileDownloadUrl(String fileKey, String serialNumber, String token, long rangeStart, long rangeEnd)
```

AI大模型

AI平台

AI应用

视频

物联网

数据上云

IoT设备

账号体系

智慧城市

电商视频解决方案

教育

全屋智能

医疗

智能制造

游戏

SDK管理

电话咨询：

服务咨询

建议反馈

产品与服务

文档与社区

关于我们

关注我们

请您联系我们

小安提醒您

1对1免费 咨询智汇云专属顾问

为您量身定制产品解决方案

1对1免费咨询智汇云专属顾问