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 die folgenden Attribute als Teil des Vorgangs SYNC melden. Weitere Informationen zum Umgang mit SYNC-Intents finden Sie unter Intent-Auftragsausführung.

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: WebRTC
• hls: HTTP-Livestreaming
• dash: Dynamisches adaptives Streaming über HTTP
• smooth_stream: Smooth Streaming
• progressive_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

Ergebnisse

Nicht-WebRTC-Ergebnisse

WebRTC-Ergebnisse

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

WebRTC-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 nur auf Smart-Displays von Google Nest unterstützt.

In diesem Abschnitt werden die Anforderungen bei Verwendung des WebRTC-Stream-Protokolls beschrieben.

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