Schemaschema für Smartstream-Kamerastream
action.devices.traits.CameraStream
: In diesem Feld wird beschrieben, wie Sie den Kamerastream eines Geräts steuern.
Diese Eigenschaft gehört zu Geräten mit der Möglichkeit, Videofeeds auf Smart Displays, Chromecast-fähigen Geräten oder Smartphones zu streamen. Im Großen und Ganzen sind dies Überwachungskameras und Babykameras. Diese Eigenschaft gilt jedoch auch für komplexere Geräte, auf denen eine Kamera verwendet wird, z. B. Geräte für Videokonferenzen oder einen Staubsauger mit einer Kamera.
Gerät ATTRIBUTE
Geräte mit diesem Attribut können im Rahmen des Vorgangs SYNC
die folgenden Attribute melden. Weitere Informationen zum Umgang mit SYNC
-Intents finden Sie unter Intent-Auftragsausführung.
Attribute | Typ | Beschreibung |
---|---|---|
cameraStreamSupportedProtocols |
Array |
Erforderlich. Unterstützte Medientypen für den Kamerastream, nach Wunsch sortiert. Normalerweise wird das erste Protokoll in diesem Array, das mit der Zieloberfläche kompatibel ist, angefordert. |
[item, ...] |
String |
Medientyp. Unterstützte Werte:
|
cameraStreamNeedAuthToken |
Boolesch |
Erforderlich. Gibt an, ob ein Authentifizierungstoken über |
Beispiele
Kamera mit mehreren Protokollen unterstützt kein Authentifizierungstoken.
{ "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
Dieses Merkmal unterstützt die folgenden Streamingprotokolle:
webrtc
: WebRTChls
: HTTP-Livestreamingdash
: Dynamisches adaptives Streaming über HTTPsmooth_stream
: Smooth Streamingprogressive_mp4
: Progressive MP4 (hauptsächlich für Clips verwendet)
Gerät STATES
Keine.
Gerätebefehle
Geräte mit diesem Attribut können im Rahmen des Vorgangs EXECUTE
auf die folgenden Befehle reagieren. Weitere Informationen zum Umgang mit EXECUTE
-Intents finden Sie unter Intent-Auftragsausführung.
action.devices.commands.GetCameraStream
Parameter
Parameter | Typ | Beschreibung |
---|---|---|
StreamToChromecast |
Boolesch |
Erforderlich. Gibt an, ob der Stream auf einem Chromecast-Gerät wiedergegeben wird. |
SupportedStreamProtocols |
Array |
Erforderlich. Vom gewünschten Ziel unterstützte Medientypen/-formate. |
[item, ...] |
String |
Medientyp. Unterstützte Werte:
|
Ergebnisse
Ergebnisse | Typ | Beschreibung |
---|---|---|
cameraStreamAuthToken |
String |
Ein Authentifizierungstoken für den jeweiligen Empfänger, um den Zugriff auf den Stream zu autorisieren. Wenn |
cameraStreamProtocol |
String |
Erforderlich. Das Medienformat, auf das die Stream-URL verweist. Es sollte eines der im Befehl Unterstützte Werte:
|
Nicht-WebRTC-Ergebnisse
Ergebnisse | Typ | Beschreibung |
---|---|---|
cameraStreamAccessUrl |
String |
Erforderlich. URL-Endpunkt zum Abrufen des Echtzeitstreams im von |
cameraStreamReceiverAppId |
String |
Die Cast-Empfänger-ID, um den Kamerastream zu verarbeiten, wenn der Parameter |
WebRTC-Ergebnisse
Ergebnisse | Typ | Beschreibung |
---|---|---|
cameraStreamSignalingUrl |
String |
Erforderlich. URL-Endpunkt zum Abrufen und Austauschen von Protokollen für Sitzungsbeschreibungen von Kameras und Clients. Der Client sollte die Signalisierungs-URL zurückgeben, die |
cameraStreamOffer |
String |
Protokoll für die Angebotssitzung (SDP) |
cameraStreamIceServers |
String |
Stellt die ICE-Server (Interactive Connectivity Setup) dar, die einen codierten JSON-String mit der Beschreibung eines RTCIceServer verwenden. Wenn Sie keine STUN-Server (Session Traversal Utilities for NAT) angeben, verwendet die Plattform standardmäßig die öffentlichen STUN-Server von Google. TURN-Server (Traversal Using Relaysround NAT) sind nur erforderlich, wenn Sie nicht garantieren können, dass die angegebenen IP-Adressen / ICE-Kandidaten öffentlich zugänglich sind (z.B. über einen Medienserver, einen ICE-Kandidaten für den öffentlichen Host oder einen Relay-ICE). |
Beispiele
Zeige die Haustürkamera (Standard-Cast-Empfänger).
{ "cameraStreamAccessUrl": "https://fluffysheep.com/baaaaa.mp4", "cameraStreamProtocol": "progressive_mp4" }
Zeig mir die Haustürkamera (benutzerdefinierter Cast-Empfänger).
{ "cameraStreamAccessUrl": "https://fluffysheep.com/baaaaa.mp4", "cameraStreamReceiverAppId": "1g2f89213hg", "cameraStreamAuthToken": "12657342190192783", "cameraStreamProtocol": "progressive_mp4" }
Zeig mir die 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ät ERRORS
Vollständige Liste der Fehler und AusnahmenWebRTC-Protokollspezifikationen
Die Vorteile von WebRTC sind eine niedrige Latenz und unidirektionale Sprechzeiten. WebRTC verwendet eine POST
-Methode mit einem POST
-Text und einer Antwort im JSON-Format.
WebRTC wird derzeit auf dem Google Nest Smart Display und Chromecast mit Google TV-Geräten unterstützt.
In diesem Abschnitt werden die Anforderungen bei Verwendung des WebRTC-Stream-Protokolls beschrieben.
Datentyp | Parameter/Definitionen |
---|---|
Signalisierungs-Anfrageheader |
Der Header sollte die folgenden Anforderungen erfüllen:
|
Parameter für Signalisierungsanfragen | Die Anfrage kann die folgenden Parameter enthalten:
|
Signalantwortparameter | Die Antwort kann die folgenden Parameter enthalten:
|
Anforderungen und Empfehlungen für WebRTC
- Google unterstützt derzeit die Einwegkommunikation (Halbduplex).
- Bundling und rtcp-mux müssen unterstützt werden.
- Sie müssen (D)TLS 1.2 oder höher verwenden.
- Trickle ICE wird nicht unterstützt. Alle ICE-Kandidaten müssen zuerst vor dem Senden des SDP gesammelt werden.
- Es wird dringend empfohlen, UDP-/IPv4-, TCP/IPv4-, UDP/IPv6- und TCP/IPv6-ICE-Kandidaten einzuschließen, um die Wahrscheinlichkeit einer erfolgreichen Verbindung zu erhöhen.
Unterstützte Videoauflösungen:
- Minimum:480 p
- Maximum: 1.080p
Unterstützte Video-Codecs:
- VP8
- H.264
Unterstützte Audio-Codecs:
- Opus (bevorzugter Codec)
- G.711/PCMU
- G.722
Cross-Origin Resource Sharing
Cross-Origin Resource Sharing (CORS) ist ein Mechanismus, der Browser mit zusätzlichen HTTP-Headern anweist, einer Webanwendung an einem Ursprung den Zugriff auf ausgewählte Ressourcen aus einem anderen Ursprung zu erlauben. Der Server, auf dem cameraStreamSignalingUrl
gehostet wird, sollte mit dem folgenden Header antworten:
Access-Control-Allow-Origin: https://www.gstatic.com
Beispiel für eine Anfrage und Antwort zur Signalisierung
Das folgende Beispiel zeigt eine Anfrage, die Google an Ihren Signalisierungsdienst sendet, sowie 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 {}