IPC 回放

更新时间:2026-01-26 08:19:57下载pdf

ThingCameraSDCardManager 是智能摄像头 SD 卡管理器,提供 SD 卡相关功能的完整接口,包括 SD 卡状态查询、格式化、录像管理等功能。

API 说明

ThingCameraSDCardManager 模块

createSDCardManager

功能描述

创建 SD 卡管理器实例。

函数签名

createSDCardManager(devId: string): Promise<boolean>;

参数说明

参数 类型 说明
devId string 设备 ID 字符串

返回值
Promise<boolean>:创建是否成功。

目前实现总是返回 true

示例

const result = await sdCardManager.createSDCardManager("device123");
console.log(result); // true

isSupportSDCard

功能描述
检查设备是否支持 SD 卡功能。

函数签名

isSupportSDCard(): Promise<boolean>

返回值
Promise<boolean>:是否支持 SD 卡。

会根据设备类型选择不同的 DP 进行检查。

示例

const isSupported = await sdCardManager.isSupportSDCard();
if (isSupported) {
  console.log("设备支持 SD 卡")
;}

isSupportFormatSDCard

功能描述
检查设备是否支持 SD 卡格式化功能。

函数签名

isSupportFormatSDCard(): Promise<boolean>

返回值
Promise<boolean>:是否支持 SD 卡格式化。

网关或子设备使用不同的 DP。

示例

const canFormat = await sdCardManager.isSupportFormatSDCard();

isSupportUnmountSDCard

功能描述
检查设备是否支持 SD 卡卸载功能。

函数签名

isSupportUnmountSDCard(): Promise<boolean>

返回值
Promise<boolean>:是否支持 SD 卡卸载。

网关或子设备使用不同的 DP。

示例

const canUnmount = await sdCardManager.isSupportUnmountSDCard();

isSupportMuteRecord

功能描述
检查设备是否支持无声录制功能。

函数签名

isSupportMuteRecord(): Promise<boolean>

返回值
Promise<boolean>:是否支持无声录制。

示例

const supportMute = await sdCardManager.isSupportMuteRecord();

getSDCardState

功能描述
获取 SD 卡当前状态。

函数签名

getSDCardState(devId: string): Promise<TSmartCameraSDCardSate | undefined>

参数说明

参数 类型 说明
devId string 设备 ID 字符串

返回值
Promise<TSmartCameraSDCardSate | undefined>:SD 卡状态枚举值或 undefined。其中,状态包括:

  • normal:正常
  • exception:异常
  • memoryLow:存储不足
  • formatting:格式化中
  • none:无卡
  • loading:加载中

示例

const state = await sdCardManager.getSDCardState("device123");
if (state === TSmartCameraSDCardSate.normal) {
  console.log("SD 卡状态正常")
;}

getSDCardInformation

功能描述
查询 SD 卡容量信息。

函数签名

getSDCardInformation(devId: string): Promise<boolean | undefined>

参数说明

参数 类型 说明
devId string 设备 ID 字符串

返回值
Promise<boolean | undefined>:查询是否成功。

实际容量信息通过监听器回调返回。

示例

const success = await sdCardManager.getSDCardInformation("device123");

formatSDCard

功能描述
格式化 SD 卡。

函数签名

formatSDCard(devId: string): Promise<boolean>

参数说明

参数 类型 说明
devId string 设备 ID 字符串

返回值
Promise<boolean>:格式化命令是否发送成功。

  • 格式化进度通过监听器回调返回。
  • 格式化会清除 SD 卡所有数据。

示例

const result = await sdCardManager.formatSDCard("device123");

unMountSDCard

功能描述
卸载 SD 卡。

函数签名

unMountSDCard(devId: string): Promise<boolean>

参数说明

参数 类型 说明
devId string 设备 ID 字符串

返回值
Promise<boolean>:卸载命令是否发送成功。

卸载后需要重新插拔 SD 卡才能使用。

示例

const result = await sdCardManager.unMountSDCard("device123");

sdCardRecordOpenState

功能描述
获取 SD 卡录像开关状态。

函数签名

sdCardRecordOpenState(devId: string): Promise<boolean | undefined>

参数说明

参数 类型 说明
devId string 设备 ID 字符串

返回值
Promise<boolean | undefined>:录像是否开启。

示例

const isRecording = await sdCardManager.sdCardRecordOpenState("device123");

enableSDCardRecord

功能描述
开启或关闭 SD 卡录像功能。

函数签名

enableSDCardRecord(devId: string, enable: boolean): Promise<boolean>

参数说明

参数 类型 说明
devId string 设备 ID 字符串
enable boolean 是否开启录像

返回值
Promise<boolean>:设置是否成功。

示例

await sdCardManager.enableSDCardRecord("device123", true);// 开启录像
await sdCardManager.enableSDCardRecord("device123", false);// 关闭录像

enableSDCardLoopRecord

功能描述
开启或关闭 SD 卡循环录像功能。

函数签名

enableSDCardLoopRecord(devId: string, enable: boolean): Promise<boolean>

参数说明

参数 类型 说明
devId string 设备 ID 字符串
enable boolean 是否开启循环录像

返回值
Promise<boolean>:设置是否成功。

循环录像会在存储满时自动覆盖最旧的录像。

示例

await sdCardManager.enableSDCardLoopRecord("device123", true);

getSDCardRecordMode

功能描述
获取 SD 卡录像模式。

函数签名

getSDCardRecordMode(devId: string): Promise<TSmartCameraDSCardRecordMode | undefined>

参数说明

参数 类型 说明
devId string 设备 ID 字符串

返回值
Promise<TSmartCameraDSCardRecordMode | undefined>:录像模式枚举值,包括:

  • event:事件录像
  • always:连续录像
  • time:定时录像

示例

const mode = await sdCardManager.getSDCardRecordMode("device123");
if (mode === TSmartCameraDSCardRecordMode.event) {
  console.log("当前为事件录像模式")
;}

setSDCardRecordMode

功能描述
设置 SD 卡录像模式。

函数签名

setSDCardRecordMode(devId: string, mode: TSmartCameraDSCardRecordMode): Promise<boolean>

参数说明

参数 类型 说明
devId string 设备 ID 字符串
mode TSmartCameraDSCardRecordMode 录像模式,枚举类型

返回值
Promise<boolean>:设置是否成功。

不同模式对设备性能和存储要求不同。

示例

await sdCardManager.setSDCardRecordMode(
  "device123", TSmartCameraDSCardRecordMode.always);

registerSDCardListener

功能描述
注册 SD 卡数据监听器。

函数签名

registerSDCardListener(listener: ThingCameraSDCardManagerListener): void

参数说明

参数 类型 说明
listener ThingCameraSDCardManagerListener 监听器对象,包含格式化进度和容量信息回调
  • 可以注册多个监听器。
  • 监听器接口包含两个回调方法。

示例

const listener = {
  sdCardFormatProgeress: (devId: string, progress: number) => {
    console.log(`格式化进度: ${progress}%`);
  },
  sdCardInfomationDidReceive: (devId: string, info: Map<string, string>) => {
    console.log(`SD卡总容量: ${info.get('totalSpace')}`);
  }};
sdCardManager.registerSDCardListener(listener);

unregisterSDCardListener

功能描述
取消注册 SD 卡数据监听器。

函数签名

unregisterSDCardListener(listener: ThingCameraSDCardManagerListener): void

参数说明

参数 类型 说明
listener ThingCameraSDCardManagerListener 要取消的监听器对象

传入的监听器对象必须与注册时相同。

示例

sdCardManager.unregisterSDCardListener(listener);

监听器接口

ThingCameraSDCardManagerListener

sdCardFormatProgeress

功能
SD 卡格式化进度回调。

参数

参数 类型 说明
devId string 设备 ID
progress number 格式化进度(0-100)

sdCardInfomationDidReceive

功能
SD 卡容量信息回调。

参数

参数 类型 说明
devId string 设备 ID
information Map<string,string> 容量信息 Map,包含 totalSpaceusedSpacefreeSpace

枚举类型

TSmartCameraSDCardSate

参数 枚举值 描述
normal 1 正常状态
exception 2 异常状态
memoryLow 3 存储空间不足
formatting 4 格式化中
none 5 无 SD 卡
loading 6 加载中

TSmartCameraDSCardRecordMode

参数 枚举值 描述
event 1 事件录像模式
always 2 连续录像模式
time 3 定时录像模式