TuyaOSIPC 开发框架类型开发包能力地图

能力地图

更新时间：2023-10-26 07:54:13下载pdf

本文介绍了 IPC 设备的基础能力及音视频处理、实时预览与对讲、录像存储、事件告警、第三方视频推送和低功耗保活唤醒等功能。涉及配网激活、网络连接、设备控制、固件 OTA 升级、音视频缓存、循环覆盖与跳帧机制、P2P 技术、双向对讲、录像控制等，可提供稳定的 IPC 连接解决方案。

设备基础能力

您可以参考《联网单品开发框架》能力地图，了解 IPC 设备基础能力。基础能力包括配网激活、网络连接、设备控制、固件 OTA 升级服务等。

音视频环形缓存

能力	说明
音视频缓存	按通道缓存不同类型的音视频数据，包括高标清视频数据、音频数据等，并复用于所有相关的流媒体业务场景。
读写同步机制	内部无锁同步机制，保障 Buffer 数据的生产者和消费者可独立任务并行高效处理不同数据帧。
循环覆盖与跳帧机制	数据生产者自动循环覆盖最老的数据。当数据使用者因为网络卡顿等因素引发读取阻塞时，自动触发跳帧策略，以避免数据异常以及编码异常。
可配置的缓存大小	根据不同的设备内存资源情况，可配置不同的缓存大小。

实时预览与对讲(P2P)

能力	说明
P2P	涂鸦自研 P2P（Peer-to-peer）技术，在设备和 App 之间建立点对点、安全加密的数据传输通路。
高标清切换	App 端根据不同的视频分辨率切换高标清通道。
双向对讲	设备端通过麦克风（Mic）采集音频发送给 App 或 Web 等终端。终端音频数据发送给设备后，通过扬声器（Speaker）播放。
状态通知	P2P 会通过事件回调，将当前的实时预览状态通知给您，例如开始拉流、结束拉流、切换清晰度等。您可以根据这些状态事件，来定义外设的表现，例如亮起监控灯、关闭监控灯等。

实时预览与对讲(WebRTC)

能力	说明
WebRTC	支持符合实时通讯技术（WebRTC，Web Real-Time Communications）标准的信令格式，能够跟支持 WebRTC 的浏览器、音箱等建立连接，实时传输音视频数据。
高标清切换	可以支持浏览器上切换不同的视频分辨率。
双向对讲	浏览器采集对话的音频，通过 WebRTC 建立的通路发送给设备。设备收到音频数据后，会通过回调接口将数据转发给您。您可以将音频数据在对应的平台上播放出来。
状态通知	WebRTC 会通过事件回调，将当前的实时预览状态通知给您，例如开始拉流、结束拉流、切换清晰度等，您可以根据这些状态事件，来定义外设的表现，例如亮起监控灯、关闭监控灯等。

录像云存储

能力	说明
订单管理	终端用户付费后，会自动激活云存储功能。在某些需要录制的场景，配合控制接口，即可进行录像的录制。当订单过期后，云存储功能会关闭，无法再通过接口来控制。
事件存储	用户购买事件存储的订单后，可以通过开始和结束的接口，来控制录像的开始录制和停止。
连续存储	用户购买了连续存储时，无需通过接口控制即可开始全天候的录制。
录像控制	可以通过录像的开始和停止接口来控制云存储功能的运行和停止，从而控制录像的开始和结束时间。
无声视频	可以通过设置无声视频的选项，来控制云存储功能仅录制视频。

录像本地存储

能力	说明
事件存储	可以通过开始和结束的接口，来控制录像的开始录制和停止。
连续存储	无需通过接口控制即可开始全天候的录制。
录像控制	可以通过录像的开始和停止接口来控制 SD 卡存储功能的运行和停止，从而控制录像的开始和结束时间。
无声视频	可以通过设置无声视频的选项，来控制 SD 卡存储功能仅录制视频。
按月查询	按照月份来查询哪些日期存在可回放的录像，您需要按照固定格式构造消息进行回复。
按天查询	按照日期来查询当天存在多少可以回放的录像片段，您需要根据固定格式构造消息进行回复。
按时间点回放	App 选定回放的时间点，设备则根据对应的时间点读取对应的录像片段，发送给 App。
倍速回放	支持 App 上选择 2 倍、4 倍、最高到 32 倍速的回放。

事件告警

能力	说明
可拓展的事件类型	支持上报多种告警事件，例如移动侦测、人形侦测、门铃呼叫等。需要 PID 上配置对应的告警事件类型，且固件层面上报接口参入对应的事件类型即可。
图片消息	您可以将图片和告警事件类型一起调用告警接口上报，最终呈现效果就是消息中心有一个对应告警的图片消息。
视频消息	对于留言类型的消息，您可以调用上报留言的接口。TUYAOS 内部会录制一段 10 秒时长（可配置）的录像上报到云端，最终呈现效果就是消息中心有一个视频留言消息。

第三方生态视频推送

能力	说明
预览	通过 WebRTC 或者云端转发技术，您无需额外对接，仅需后台付费开通即可支持在 echoshow/chromecast 进行查看摄像头的实时视频流。
双向对讲	您只需要对接音频数据的回调接口及播放音频，即可支持在 echoshow/chromecast 与设备进行对讲。

低功耗保活唤醒

能力	说明
TCP 保活服务	您若要开发低功耗产品，需要接入云端提供的 TCP 保活服务，其中包括连接、鉴权、加解密等部分的内容。当设备连接上云端的 TCP 保活服务后，云端会自动关闭与设备正常通信的 MQTT 连接，且不会出现离线记录。
保活唤醒	当 App 操作设备唤醒时，云端会从 TCP 保活连接上，向设备发送唤醒数据。收到唤醒数据后，您需要正常唤醒主控设备，并使其上线连接到涂鸦 MQTT 服务。这时候，云端会自动关闭低功耗 TCP 保活连接，且不会出现离线记录。

上一篇快速入门

下一篇配网绑定