IPC 回放

概述

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

API接口

ThingCameraSDCardManager 模块

createSDCardManager

功能描述
创建SD卡管理器实例

函数签名

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

参数说明

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

返回值
Promise: 创建是否成功

注意
目前实现总是返回true

示例

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

isSupportSDCard

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

函数签名

isSupportSDCard(): Promise<boolean>

参数说明
无

返回值
Promise: 是否支持SD卡

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

示例

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

isSupportFormatSDCard

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

函数签名

isSupportFormatSDCard(): Promise<boolean>

参数说明
无

返回值
Promise: 是否支持SD卡格式化

注意
网关或子设备使用不同的DP点

示例

const canFormat = await sdCardManager.isSupportFormatSDCard();

isSupportUnmountSDCard

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

函数签名

isSupportUnmountSDCard(): Promise<boolean>

参数说明
无

返回值
Promise: 是否支持SD卡卸载

注意
网关或子设备使用不同的DP点

示例

const canUnmount = await sdCardManager.isSupportUnmountSDCard();

isSupportMuteRecord

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

函数签名

isSupportMuteRecord(): Promise<boolean>

参数说明
无

返回值
Promise: 是否支持无声录制

注意
无

示例

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: 格式化命令是否发送成功

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

示例

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

unMountSDCard

功能描述
卸载SD卡

函数签名

unMountSDCard(devId: string): Promise<boolean>

参数说明

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

返回值
Promise: 卸载命令是否发送成功

注意
卸载后需要重新插拔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: 设置是否成功

注意
无

示例

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: 设置是否成功

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

示例

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: 设置是否成功

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

示例

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，包含totalSpace、usedSpace、freeSpace

枚举类型

TSmartCameraSDCardSate

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

TSmartCameraDSCardRecordMode

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