Skema Sifat CameraStream Smart Home

action.devices.traits.CameraStream - Atribut ini membahas cara mengontrol streaming kamera perangkat.

Ciri ini dimiliki oleh perangkat yang memiliki kemampuan untuk melakukan streaming feed video ke layar smart, perangkat berkemampuan Chromecast, atau smartphone. Pada umumnya, ini adalah kamera keamanan atau kamera bayi. Namun, sifat 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 lebih lanjut cara menangani intent SYNC, lihat Fulfillment intent.

Contoh

Kamera dengan dukungan beberapa protokol, tidak memerlukan token autentikasi.

{
  "cameraStreamSupportedProtocols": [
    "webrtc",
    "hls",
    "dash",
    "smooth_stream",
    "progressive_mp4"
  ],
  "cameraStreamNeedAuthToken": false
}

Kamera yang mendukung satu protokol, yang memerlukan token autentikasi.

{
  "cameraStreamSupportedProtocols": [
    "hls"
  ],
  "cameraStreamNeedAuthToken": true
}

Protokol streaming yang didukung

Sifat ini mendukung protokol streaming berikut:

• webrtc: WebRTC
• hls: HTTP Live Streaming
• dash: Dynamic Adaptive Streaming over HTTP
• smooth_stream: Streaming Lancar
• progressive_mp4: MP4 progresif (sebagian besar digunakan untuk klip)

Saat melakukan streaming protokol hls,dash,smooth_stream, dan progressive_mp4 ke perangkat Cast (Chromecast, layar smart, dan smart TV yang kompatibel dengan Chromecast), Penerima Web Cast diluncurkan untuk memproses streaming dan merendernya di perangkat. Sebaiknya developer membuat Penerima Web Kustom untuk mengaktifkan akses ke alat proses debug, menyesuaikan perilaku pemutar, menyesuaikan branding UI, dan menyertakan analisis. Untuk mengaktifkan penggunaan penerima kustom dan memilih tidak menggunakan penerima default, tetapkan ID aplikasi penerima yang dihasilkan saat Anda mendaftarkan aplikasi Cast di kolom cameraStreamReceiverAppId respons EXECUTE.

Untuk mempelajari aplikasi Penerima Web Kustom lebih lanjut, buka panduan Situs Developer.

Status PERANGKAT

Tidak ada.

Perintah Perangkat

Perangkat dengan karakteristik ini dapat merespons perintah berikut sebagai bagian dari operasi EXECUTE. Untuk mempelajari lebih lanjut cara menangani intent EXECUTE, lihat Fulfillment intent.

action.devices.commands.GetCameraStream

Parameter

Hasil

Hasil non-WebRTC

Hasil WebRTC

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 (streaming 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"
}

ERROR Perangkat

Spesifikasi protokol WebRTC

Manfaat menggunakan WebRTC adalah latensi rendah dan percakapan 1 arah. WebRTC menggunakan metode POST dengan isi dan respons POST dalam format JSON.

WebRTC saat ini didukung di Layar Smart Google Nest dan Chromecast dengan perangkat Google TV.

Bagian ini menjelaskan persyaratan saat menggunakan protokol streaming WebRTC.

Persyaratan dan Rekomendasi WebRTC

• Google saat ini mendukung komunikasi 1 arah (half duplex).
• 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.
• Sebaiknya sertakan kandidat ICE UDP/IPv4, TCP/IPv4, UDP/IPv6, dan TCP/IPv6 untuk meningkatkan kemungkinan koneksi yang berhasil.

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

Cross-Origin Resource Sharing (CORS)

Cross-Origin Resource Sharing (CORS) adalah mekanisme yang menggunakan Header HTTP tambahan untuk memberi tahu browser agar mengizinkan aplikasi web yang berjalan di satu origin untuk mengakses resource yang dipilih dari origin yang berbeda. Server yang menghosting cameraStreamSignalingUrl harus merespons dengan header berikut:

Access-Control-Allow-Origin: https://www.gstatic.com

Contoh permintaan dan respons sinyal

Contoh berikut menunjukkan permintaan yang dikirim Google ke layanan sinyal Anda dan respons yang sesuai ke 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
{}