使用手冊

Native C/C++ SDK

整合 stable C ABI、C++ wrapper、transport、signaling 與 direct media upload。

安裝與 ABI

Release archive 包含 librtk_cloud_client.a、public header 與匯出 rtk::cloud_client 的 CMake metadata。C 使用 rtkc.h,C++ 使用 thin wrapper rtkc.hpp。所有 public request struct 必須以對應 rtkc_*_init 初始化;handle 視為 opaque,SDK allocation 用配對 API release。

Lifecycle 與能力

以 validated endpoint、auth、callback、transport 與 timeout 建立 client。Session 必須依序 connect、process、disconnect、destroy,最後 destroy client。Public API 包含 token、device lifecycle、event/log、command、telemetry、firmware、snapshot、media 與 WebRTC signaling helper。

Direct clip upload

先 authorize,再以 rtkc_presigned_stream_put_request_t 設定 HTTPS URL、signed header、exact body size、read/progress/cancel callback 與 bounded buffer;PUT 成功後 complete 並查詢 readiness。不得把 Video Cloud bearer token 送到 object storage,也不支援 S3 multipart upload。

驗證

以 CMake/CTest、package consumer smoke、platform transport test 與 approved deployed-server harness 驗證。WebRTC media engine、track 與 renderer 仍由 product/device integration 負責。

其他手冊章節

繼續閱讀相關手冊章節。

SDK 總覽

選擇 package 並理解支援邊界。

開啟章節

開始使用

安裝 SDK、設定 client 並完成第一次 request。

開啟章節

認證與安全

安全處理 token、PKI、TLS、key 與 media。

開啟章節

生命週期與錯誤

處理 timeout、retry、cancel、callback 與 shutdown。

開啟章節

能力工作流

整合 provisioning、device、telemetry、OTA、command 與 signaling。

開啟章節

Video Cloud 工作流

整合 Live WebRTC signaling 與 encrypted stored video。

開啟章節

Android Kotlin SDK

使用 coroutine、signaling、Media3 與 secure key provider。

開啟章節

iOS Swift SDK

使用 async API、signaling、AVPlayer、Keychain 與 Secure Enclave。

開啟章節

JavaScript/TypeScript SDK

在 browser 與 Node.js 整合 typed ESM package。

開啟章節

Go SDK

用 pure Go client 整合 device、tool 與 automation。

開啟章節

FreeRTOS/Pro2 SDK

整合 board、transport、media 與 WebRTC answerer adapter。

開啟章節

Sample applications

正確使用 Android、iOS、Web、Linux 與 Pro2 sample。

開啟章節

除錯與相容性

診斷認證、transport、upload、playback 與版本問題。

開啟章節