Skema Tray CameraStream Smart Home
action.devices.traits.CameraStream
- Sifat ini mencakup cara mengontrol aliran kamera perangkat.
Sifat ini termasuk dalam perangkat yang memiliki kemampuan untuk melakukan streaming feed video ke layar smart, perangkat berkemampuan Chromecast, atau smartphone. Umumnya, ini adalah kamera keamanan atau kamera bayi. Namun, fitur ini juga berlaku untuk perangkat yang lebih kompleks yang memiliki kamera (misalnya, perangkat konferensi video atau robot penyedot debu dengan kamera).
ATRIBUT Perangkat
Perangkat dengan karakteristik ini dapat melaporkan atribut
berikut sebagai bagian dari operasi SYNC
. Untuk mempelajari
penanganan intent SYNC
lebih lanjut, lihat
fulfillment intent.
Atribut | Type | Deskripsi |
---|---|---|
cameraStreamSupportedProtocols |
Array |
Wajib. Jenis media yang didukung untuk streaming kamera, diurutkan berdasarkan preferensi. Biasanya, protokol pertama dalam array ini yang kompatibel dengan platform target diminta. |
[item, ...] |
String |
Jenis media. Nilai yang didukung:
|
cameraStreamNeedAuthToken |
Boolean |
Wajib. Apakah token autentikasi akan diberikan melalui |
Contoh
Kamera dengan beberapa dukungan protokol, tidak memerlukan token autentikasi.
{ "cameraStreamSupportedProtocols": [ "webrtc", "hls", "dash", "smooth_stream", "progressive_mp4" ], "cameraStreamNeedAuthToken": false }
Kamera mendukung satu protokol, memerlukan token autentikasi.
{ "cameraStreamSupportedProtocols": [ "hls" ], "cameraStreamNeedAuthToken": true }
Protokol streaming yang didukung
Sifat ini mendukung protokol streaming berikut:
webrtc
: WebRTChls
: Live Streaming HTTPdash
: Streaming Adaptif Dinamis melalui HTTPsmooth_stream
: Streaming Lancarprogressive_mp4
: MP4 progresif (sebagian besar digunakan untuk klip)
STATE Perangkat
Tidak ada.
PERMINTAAN Perangkat
Perangkat dengan karakteristik ini dapat merespons perintah berikut sebagai bagian dari operasi EXECUTE
. Untuk mempelajari
penanganan intent EXECUTE
lebih lanjut, lihat
fulfillment intent.
action.devices.commands.GetCameraStream
Parameter
Parameter | Type | Deskripsi |
---|---|---|
StreamToChromecast |
Boolean |
Wajib. Apakah streaming akan diputar di perangkat Chromecast. |
SupportedStreamProtocols |
Array |
Wajib. Jenis/format media yang didukung oleh tujuan yang diinginkan. |
[item, ...] |
String |
Jenis media. Nilai yang didukung:
|
Hasil
Hasil | Type | Deskripsi |
---|---|---|
cameraStreamAuthToken |
String |
Token autentikasi bagi penerima tertentu untuk mengizinkan akses ke streaming. Jika |
cameraStreamProtocol |
String |
Wajib. Format media yang dituju oleh URL streaming. Harus berupa salah satu protokol yang tercantum dalam parameter perintah Nilai yang didukung:
|
Hasil non-WebRTC
Hasil | Type | Deskripsi |
---|---|---|
cameraStreamAccessUrl |
String |
Wajib. Endpoint URL untuk mengambil aliran real-time dalam format yang ditentukan oleh |
cameraStreamReceiverAppId |
String |
ID penerima transmisi untuk memproses streaming kamera saat parameter |
Hasil WebRTC
Hasil | Type | Deskripsi |
---|---|---|
cameraStreamSignalingUrl |
String |
Wajib. Endpoint URL untuk mengambil dan bertukar protokol deskripsi sesi (SDP) kamera dan klien. Klien harus menampilkan URL sinyal yang menggunakan |
cameraStreamOffer |
String |
Tawarkan protokol deskripsi sesi (SDP). |
cameraStreamIceServers |
String |
Mewakili server Interactive Connectivity Establishment (ICE) menggunakan string JSON yang dienkode dengan deskripsi RTCIceServer. Jika Anda tidak menentukan server STUN (Session Traversal Utilities for NAT), platform ini akan ditetapkan secara default ke server STUN publik Google. Server Turn (Traversal Using Relays about NAT) hanya diperlukan jika Anda tidak dapat menjamin kandidat IP / ICE yang diberikan akan dapat diakses secara publik (misalnya melalui server media, kandidat ICE host publik, kandidat ICE relai, dll). |
Contoh
Tampilkan kamera pintu depan (penerima Transmisi default).
{ "cameraStreamAccessUrl": "https://fluffysheep.com/baaaaa.mp4", "cameraStreamProtocol": "progressive_mp4" }
Tampilkan kamera pintu depan (penerima Transmisi kustom).
{ "cameraStreamAccessUrl": "https://fluffysheep.com/baaaaa.mp4", "cameraStreamReceiverAppId": "1g2f89213hg", "cameraStreamAuthToken": "12657342190192783", "cameraStreamProtocol": "progressive_mp4" }
Tampilkan kamera pintu depan (aliran data WebRTC).
{ "cameraStreamIceServers": "[{\"urls\": \"stun:stun.l.partner.com:19302\"},{\"urls\":\"turn:192.158.29.39:3478?transport=udp\",\"credential\": \"JZEOEt2V3Qb0y27GRntt2u2PAYA=\",\"username\": \"28224511:1379330808\"},{\"urls\": \"turn:192.158.29.39:3478?transport=tcp\",\"credential\": \"JZEOEt2V3Qb0y27GRntt2u2PAYA=\",\"username\": \"28224511:1379330808\"}]", "cameraStreamSignalingUrl": "https://example.com/signaling/answer", "cameraStreamOffer": "o=- 4611731400430051336 2 IN IP4 127.0.0.1...", "cameraStreamProtocol": "webrtc" }
ERRORS perangkat
Lihat daftar lengkap error dan pengecualian.Spesifikasi protokol WebRTC
Manfaat menggunakan WebRTC adalah latensi rendah dan percakapan 1 arah. WebRTC menggunakan metode POST
dengan isi POST
dan respons dalam format JSON.
WebRTC saat ini didukung di perangkat Layar Smart Google Nest dan Chromecast dengan Google TV.
Bagian ini menjelaskan persyaratannya saat menggunakan protokol streaming WebRTC.
Jenis Data | Parameter/Definisi |
---|---|
Header permintaan sinyal |
Header harus memenuhi persyaratan berikut:
|
Parameter permintaan sinyal | Permintaan dapat menyertakan parameter berikut:
|
Parameter respons sinyal | Responsnya dapat mencakup parameter berikut:
|
Persyaratan dan Rekomendasi WebRTC
- Google saat ini mendukung komunikasi 1 arah (setengah dupleks).
- Anda harus mendukung bundling dan rtcp-mux.
- Anda harus menggunakan (D)TLS 1.2 atau yang lebih baru.
- Trickle ICE tidak didukung. Semua kandidat ICE harus dikumpulkan terlebih dahulu sebelum mengirim SDP.
- Sangat disarankan untuk menyertakan kandidat UDP/IPv4, TCP/IPv4, UDP/IPv6, dan TCP/IPv6 ICE untuk meningkatkan peluang keberhasilan koneksi.
Resolusi video yang didukung:
- Minimum: 480p
- Maksimum: 1080p
Codec video yang didukung:
- VP8
- H.264
Codec audio yang didukung:
- Opus (codec pilihan)
- G.711/PCMU
- G.722
Berbagi Resource Lintas Asal
Cross-Origin Resource Sharing (CORS) adalah mekanisme yang menggunakan Header HTTP tambahan untuk memberi tahu
browser agar aplikasi web yang berjalan di satu tempat dapat mengakses resource yang dipilih dari
tempat asal berbeda. Server yang menghosting cameraStreamSignalingUrl
harus merespons dengan header berikut:
Access-Control-Allow-Origin: https://www.gstatic.com
Contoh permintaan dan respons pemberian sinyal
Contoh berikut menunjukkan permintaan yang dikirim Google ke layanan pensinyalan Anda dan respons yang sesuai kepada Google.
Header: Authentication: Bearer <cameraStreamAuthToken> Content-Type: application/json POST body: // When camera offer SDP is provided in the execution response, Google provides an answer SDP. { "action": "answer", "deviceId": "123", "sdp": "o=- 4611731400430051336 2 IN IP4 127.0.0.1..." } // When camera offer SDP is not provided in execution response, Google generates and provides an offer SDP. { "action": "offer", "deviceId": "123", "sdp": "o=- 4611731400430051336 2 IN IP4 127.0.0.1..." } // Close the current stream session. { "action": "end" "deviceId": "123" }
// Response to accept the answer SDP in the request. Response Code : 200 {} // Response to provide the answer SDP from the service provider. Response Code : 200 { // When the camera offer SDP is not provided in the execution response, // Google provides the answer SDP via the signaling response. "action": "answer" "sdp": "o=- 4611731400430051336 2 IN IP4 127.0.0.1..." } // Response to close current session. Response Code : 200 {}