HarmonyOS SDK 接入

CFlutterReact NativeAndroidiOSHarmonyOS

下载更新记录API 说明示例源码

确认运行环境

DevEco Studio 或 OpenHarmony SDK 12 及以上；运行设备支持 arm64-v8a 原生库。

添加 SDK 依赖

{
  "dependencies": {
    "tirtc": "2.4.0-alpha.3"
  }
}

初始化并查询录像

appId 来自申请开通。appAccessToken 由自己的业务服务端签发，见云端签发 Token。查询时间使用 UTC Unix 毫秒。

import {
  TiCloudStorage,
  TiCloudStorageReplaySpeed,
  TI_CLOUD_STORAGE_ERROR_OK,
} from 'tirtc';

const initCode = await TiCloudStorage.init({
  context: uiAbilityContext,
  appId,
});
if (initCode !== TI_CLOUD_STORAGE_ERROR_OK) {
  throw new Error(TiCloudStorage.errorToString(initCode));
}
const cloudStorage = new TiCloudStorage(appAccessToken);
const result = await cloudStorage.listRecordings(startTimeMs, endTimeMs);
if (result.code !== TI_CLOUD_STORAGE_ERROR_OK) {
  throw new Error(TiCloudStorage.errorToString(result.code));
}
const recordings = result.recordings;

页面退出时，先从组件树移除 TiCloudStorageVideoOutputView，再停止 Replay。然后依次 detach 和 dispose 两个 Output，最后 dispose Replay 与 TiCloudStorage 实例。

配置回放速度

Replay 支持 x0_125、x0_25、x0_5、x1、x2、x4、x8 七档速度，分别对应 1/8、1/4、1/2、1、2、4、8 倍速。三档慢速采用持帧显示；非 1 倍速时 Audio Output 自动静音。

replay.setSpeed(TiCloudStorageReplaySpeed.x0_5);

确认可以查询录像

查询成功且 recordings 非空，说明初始化和 Token 鉴权均已通过，查询范围内也存在录像。列表为空时，确认查询范围覆盖设备已经完成上传的 UTC 时间。