Smart Home CameraStream Trait Schema

action.devices.traits.CameraStream: Mit diesem Attribut wird festgelegt, wie der Kamerastream eines Geräts gesteuert wird.

Diese Eigenschaft gilt für Geräte, die Videofeeds auf Smart Displays, Chromecast-fähige Geräte oder Smartphones streamen können. In der Regel handelt es sich dabei um Überwachungskameras oder Babyfone. Diese Eigenschaft gilt aber auch für komplexere Geräte mit Kamera, z. B. Videokonferenzgeräte oder Staubsaugerroboter mit Kamera.

Geräteattribute

Geräte mit dieser Eigenschaft können im Rahmen des Vorgangs SYNC die folgenden Attribute melden. Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Intent-Ausführung.

Beispiele

Kamera mit Unterstützung mehrerer Protokolle, für die kein Authentifizierungstoken erforderlich ist.

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

Kamera, die ein einzelnes Protokoll unterstützt und ein Authentifizierungstoken erfordert

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

Unterstützte Streamingprotokolle

Diese Eigenschaft unterstützt die folgenden Streamingprotokolle:

• webrtc: WebRTC
• hls: HTTP Live Streaming
• dash: Dynamic Adaptive Streaming over HTTP
• smooth_stream: Smooth Streaming
• progressive_mp4: Progressives MP4 (wird hauptsächlich für Clips verwendet)

Beim Streamen von hls-, dash-, smooth_stream- und progressive_mp4-Protokollen auf Cast-Geräte (Chromecast, Smart Displays und Chromecast-fähige Smart-TVs) wird ein Cast-Webreceiver gestartet, um den Stream zu verarbeiten und auf dem Gerät zu rendern. Es wird empfohlen, einen benutzerdefinierten Webreceiver zu erstellen, um den Zugriff auf Debugging-Tools zu ermöglichen, das Playerverhalten anzupassen, das UI-Branding anzupassen und Analysen einzubinden. Wenn du die Verwendung des benutzerdefinierten Empfängers aktivieren und die Verwendung des Standardempfängers deaktivieren möchtest, setze die Empfänger-App-ID, die beim Registrieren deiner Cast-Anwendung generiert wird, im Feld cameraStreamReceiverAppId der EXECUTE-Antwort.

Weitere Informationen zu benutzerdefinierten Webreceiver-Anwendungen findest du in diesem Leitfaden auf der Website für Entwickler.

GERÄTESTATUS

Keine.

Gerätebefehle

Geräte mit dieser Eigenschaft können im Rahmen des Vorgangs EXECUTE auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE-Intents finden Sie unter Intent-Ausführung.

action.devices.commands.GetCameraStream

Parameter

Ergebnisse

Nicht WebRTC-Ergebnisse

WebRTC-Ergebnisse

Beispiele

Zeig mir das Bild der Haustürkamera (Standard-Cast-Empfänger).

{
  "cameraStreamAccessUrl": "https://fluffysheep.com/baaaaa.mp4",
  "cameraStreamProtocol": "progressive_mp4"
}

Zeig mir das Bild der Haustürkamera (benutzerdefinierter Cast-Empfänger)

{
  "cameraStreamAccessUrl": "https://fluffysheep.com/baaaaa.mp4",
  "cameraStreamReceiverAppId": "1g2f89213hg",
  "cameraStreamAuthToken": "12657342190192783",
  "cameraStreamProtocol": "progressive_mp4"
}

Zeig mir das Bild der Haustürkamera (WebRTC-Stream).

{
  "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"
}

GERÄTEFEHLER

WebRTC-Protokollspezifikationen

Die Vorteile von WebRTC sind eine geringe Latenz und eine Einweg-Unterstützung. WebRTC verwendet die POST-Methode mit einem POST-Text und einer Antwort im JSON-Format.

WebRTC wird derzeit auf Google Nest Smart Displays und Chromecast mit Google TV-Geräten unterstützt.

In diesem Abschnitt werden die Anforderungen bei der Verwendung des WebRTC-Streams beschrieben.

WebRTC-Anforderungen und -Empfehlungen

• Google unterstützt derzeit nur die Einweg-Kommunikation (Halbduplex).
• Sie müssen Bündelung und RTCP-Mux unterstützen.
• Sie müssen (D)TLS 1.2 oder höher verwenden.
• Trickle ICE wird nicht unterstützt. Alle ICE-Kandidaten müssen zuerst erfasst werden, bevor die SDP gesendet wird.
• Wir empfehlen dringend, UDP/IPv4-, TCP/IPv4-, UDP/IPv6- und TCP/IPv6-ICE-Kandidaten anzugeben, um die Wahrscheinlichkeit einer erfolgreichen Verbindung zu erhöhen.

Unterstützte Videoauflösungen:

• Mindestwert:480p
• Maximal:1080p

Unterstützte Videocodecs:

• VP8
• H.264

Unterstützte Audiocodecs:

• Opus (bevorzugter Codec)
• G.711/PCMU
• G.722

Cross-Origin Resource Sharing

Cross-Origin Resource Sharing (CORS) ist ein Mechanismus, der zusätzliche HTTP-Header verwendet, um Browsern mitzuteilen, dass eine Webanwendung, die an einem Ursprung ausgeführt wird, auf ausgewählte Ressourcen eines anderen Ursprungs zugreifen darf. Der Server, auf dem cameraStreamSignalingUrl gehostet wird, muss mit dem folgenden Header antworten:

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

Beispiel für eine Signalanfrage und -antwort

Das folgende Beispiel zeigt eine Anfrage, die Google an Ihren Signalisierungsdienst sendet, und die entsprechende Antwort an 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
{}