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

首页> 开发者中心>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开发平台

视觉分析

内容审核

人脸与人体识别

OCR识别

图像技术

AI市场

基础组件

视频应用

视频工具

物联网平台

网络与CDN

应用开发

研发效能

视频应用

企业工具

安全应用

云计算

大数据

容器服务

AI开发平台

视频

物联网

数据上云

IoT设备

账号体系

智慧城市

电商视频解决方案

教育

全屋智能

医疗

智能制造

游戏

SDK管理

电话咨询：

热门产品

帮助文档

服务条款

关注或联系我们

请您联系我们

小安提醒您

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

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

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