重点
此服务涵盖什么
- Live WebRTC 使用 HTTPS control API 与目前 device owner 的 MQTT 或 WebSocket transport
- Recording、stored clip 与 snapshot 使用獨立于 live viewing 的加密上傳及播放 lifecycle
- Live media frame 保持在 peer-to-peer 或 TURN relay 路徑，不会由云端自動保存
Live WebRTC 与加密 stored video 是兩條獨立产品路徑。
Video Cloud
Realtek Connect+ 提供 Android 与 iOS SDK，用于云端 signaling 与 stored-video workflow。Product app 将这些 SDK 与平台 WebRTC 及 media component 整合，交付最終观看体验。
能力
平台基础能力
- HTTPS ICE、session create、answer retrieval、close、expiry 与 failure-state helper
- 透过 current-owner MQTT 或 WebSocket 傳送相同 webrtc_offer signaling payload；不 fan-out，也不自動 fallback 到非 owner transport
- Authorize、presigned upload、complete、list、thumbnail、短效播放、URL refresh 与 delete workflow
成果
产品团队为何使用
- 整合云端 signaling，不需另建 signaling backend
- 由 App 团队掌握 platform WebRTC rendering 与产品 UX
- 让 live viewing、recording、clip 与 snapshot 在营运和技术上保持清楚区隔
Live WebRTC
单一 signaling lifecycle，media 由兩端負責
Realtek Connect+ 协調 signaling 与 ICE/TURN；App 与 Device 連接並呈现实際 media。
-
取得 ICE
App 透过 RTK SDK 呼叫 HTTPS ICE API。
-
建立 offer
App 的 platform WebRTC component 建立 SDP offer。
-
开启 session
RTK SDK 透过 HTTPS 建立 signaling session。
-
傳送 offer
Cloud 經目前 device owner 的 MQTT 或 WebSocket transport 送出 webrtc_offer。
-
建立 answer
Device SDK 或 firmware 接收 offer、連接 camera/audio track 並建立 answer。
-
提交 answer
Device 經 HTTPS answer API 回覆 SDP answer。
-
协商 media
App 經 RTK SDK 取得 answer，完成 platform media negotiation。
-
关閉
App 或 Device 关閉 session；expiry 与 timeout 也会終止 stale session。
Stored video
完整 media object 加密后直接上傳
Stored clip 由獨立 recording 与 upload workflow 建立；live session 絕不会自動變成 clip。
-
录製
产品录製完整 MP4 clip 或擷取 JPEG snapshot。
-
加密
Client 加密 media object，wrapped-key material 不写入 log。
-
授权
RTK SDK 取得 upload lifecycle 与短效 presigned PUT URL。
-
上傳
Client 在 upload lifecycle 内執行一次 object-storage PUT。
-
完成
SDK 标记 upload complete，service 验证后公开 ready object。
-
浏览与播放
App 进行 list、filter、pagination、thumbnail、短效 range URL refresh、playback 与 delete。
权責矩阵
連接每一層，同时保留清楚邊界
同一組权責分工適用于产品架構、SDK 评估与支援除錯。
| 層級 | 提供能力 | 整合邊界 |
|---|---|---|
| Realtek Connect+ Cloud | HTTPS signaling、current-owner MQTT/WebSocket delivery、TURN credential、session state 与 stored-video lifecycle API。 | 协調 control 与 storage workflow；不接收或保存 Live media frame。 |
| RTK Android/iOS SDK | Authentication、ICE、offer/answer/close helper、stable error 与 clip workflow helper。 | 将 session 与 media-object data 交給 product app；不包含完整 WebRTC renderer。 |
| Product app | 产品專属 live 与 recorded viewing experience。 | 整合 platform WebRTC、renderer、audio policy、lifecycle、controls、empty/error states 与 playback URL refresh。 |
| Device SDK / firmware | Offer handling、answer generation、camera/audio tracks、recording、encryption 与 resource enforcement。 | 負責 physical media validation、codec、track attachment 与 constrained-device behavior。 |
Sample truth matrix
依各 sample 实際能力进行验证
Fixture 与 host-smoke sample 是有用的整合证據，但不等同 physical media validation。
| Sample | 可見状态 | 验证内容 | 不代表 |
|---|---|---|---|
| Android playback | Real SDK + Media3 | Stored clip list 与 playback integration。 | Live WebRTC rendering。 |
| iOS playback | Real SDK + AVPlayer | Stored clip list 与 playback integration。 | Live WebRTC rendering。 |
| Android/iOS Live | RTK signaling integration / fixture UI | Session data、offer/answer、close 与 UI lifecycle。 | 完整 media rendering 或 physical camera validation。 |
| WebApp Ops Lab | Fixture-backed | Signaling helper demonstration 与 operations workflow。 | Production WebRTC peer 或 native onboarding。 |
| Linux simulator | Device workflow simulator | Command、state、report 与 validation evidence。 | Camera frame 或 WebRTC signaling。 |
| PRO2 host smoke | Adapter + lifecycle smoke | Adapter wiring 与 signaling lifecycle。 | Physical camera、audio、codec 或 rendered-media validation。 |
Snapshot 与 Clip
依使用者動作选择正確 media object
兩者共享授权和安全交付概念，但不能互換。
- Snapshot 是用于预览、alert 或单一时間点检视的 JPEG 靜态圖；目前 technical default 上限为 5 MiB。
- Clip 是用于 recorded playback 的完整 MP4 media object；目前 technical default 上限为 256 MiB。
- 除非产品明確录製並執行 stored-video workflow，否則 Live WebRTC 不会产生任何 stored object。
Retention 与 URL 预設值
将目前數值视为部署設定，不是價格或 SLA
部署营运者选择適用 storage policy；商务、region、backup 与 recovery 需求需另外確認。
- Retention profile 可依 deployment 設定为 1、7 或 30 天。
- Signed upload 与 playback URL 目前预設有效 10 分鐘；client 应更新 playback URL，不应永久保存。
- Authorized upload lifecycle 目前预設 30 分鐘，未完成时进入 failed 或 expired。
- 本页所有 limits 都是目前 technical defaults，不是價格、quota 承諾、backup 承諾、region 承諾或 SLA。
Current release boundary
清楚知道产品整合仍負責什么
SDK 減少 cloud workflow boilerplate，同时保留明確的 media 与 UX ownership。
- 目前版本不包含 server-side transcoding、S3 multipart upload、simulcast negotiation、renegotiation，也不提供完整的 SDK 内建 WebRTC media renderer。
- Product app 負責 platform WebRTC component、media renderer、audio policy、foreground/background lifecycle 与最終观看 UX。
- Device SDK 或 firmware 負責 offer handling、answer generation、camera/audio tracks、codec 与装置 resource limits。
相关内容
繼續整合路徑
下一步
评估 Video Cloud 如何支援你的产品路线圖。
分享你的产品类别、目标部署与云端需求，让 Realtek Connect+ 团队协助评估。