แบบแผน SmartStream CameraStream

action.devices.traits.CameraStream - ลักษณะนี้ครอบคลุมวิธีการควบคุมกระแสกล้องของอุปกรณ์

ลักษณะนี้เป็นของอุปกรณ์ที่สามารถสตรีมวิดีโอฟีดไปยัง Smart Display, อุปกรณ์ที่พร้อมใช้งาน Chromecast หรือสมาร์ทโฟน กล้องเหล่านี้คือกล้องวงจรปิดหรือกล้องสําหรับทารก แต่ลักษณะการใช้งานนี้ใช้กับอุปกรณ์ที่ซับซ้อนมากขึ้นซึ่งมีกล้องติดตั้งอยู่ด้วย (เช่น อุปกรณ์การประชุมทางวิดีโอหรือหุ่นยนต์เครื่องดูดฝุ่นที่มีกล้องอยู่)

แอตทริบิวต์ของอุปกรณ์

อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจรายงานแอตทริบิวต์ต่อไปนี้เป็นส่วนหนึ่งของการดําเนินการ SYNC หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ SYNC โปรดดูการดําเนินการ Intent

ตัวอย่าง

กล้องที่มีโปรโตคอลหลายแบบรองรับโดยไม่ต้องใช้โทเค็นการตรวจสอบสิทธิ์

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

กล้องที่รองรับโปรโตคอลเดี่ยวต้องใช้โทเค็นการตรวจสอบสิทธิ์

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

โปรโตคอลสตรีมมิงที่รองรับ

ลักษณะเฉพาะนี้สนับสนุนโปรโตคอลสตรีมมิงต่อไปนี้

• webrtc: WebRTC
• hls: สตรีมมิงแบบสด HTTP
• dash: การสตรีมที่ปรับเปลี่ยนได้แบบไดนามิกผ่าน HTTP
• smooth_stream: สตรีมมิงที่ราบรื่น
• progressive_mp4: Progressive MP4 (ใช้สําหรับคลิป)

อุปกรณ์ STATES

ไม่มี

อุปกรณ์ COMMANDS

อุปกรณ์ที่มีลักษณะเฉพาะนี้อาจตอบสนองต่อคําสั่งต่อไปนี้ในฐานะส่วนหนึ่งของการดําเนินการ EXECUTE หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับการจัดการ Intent ของ EXECUTE โปรดดูการดําเนินการ Intent

action.devices.commands.GetCameraStream

พารามิเตอร์

ผลลัพธ์

ผลลัพธ์ที่ไม่ใช่ WebRTC

ผลลัพธ์ของ WebRTC

ตัวอย่าง

แสดงกล้องประตูหน้า (ตัวรับการแคสต์เริ่มต้น)

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

แสดงกล้องประตูหน้า (ตัวรับการแคสต์ที่กําหนดเอง)

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

แสดงกล้องประตูหน้า (สตรีม 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

ข้อกําหนดโปรโตคอล WebRTC

ประโยชน์ของการใช้ WebRTC คือเวลาในการตอบสนองต่ําและการสื่อสารทางเดียว WebRTC จะใช้เมธอด POST ที่มีเนื้อความ POST และการตอบสนองในรูปแบบ JSON

ปัจจุบัน WebRTC รองรับ Smart Display ของ Google Nest และ Chromecast ที่มีอุปกรณ์ Google TV

ส่วนนี้จะอธิบายถึงข้อกําหนดเมื่อใช้โปรโตคอลสตรีม WebRTC

ข้อกําหนดและคําแนะนําสําหรับ WebRTC

• ปัจจุบัน Google รองรับการสื่อสารแบบทางเดียว (ครึ่งหนึ่ง)
• คุณต้องสนับสนุนการรวมกลุ่มอีเมล และ rtcp-mux
• คุณต้องใช้ (D)TLS 1.2 ขึ้นไป
• ไม่รองรับ Trickle ICE ต้องรวบรวมผู้สมัคร ICE ทั้งหมดก่อนการส่ง SDP
• ขอแนะนําอย่างยิ่งให้คุณระบุผู้สมัคร ICE จาก UDP/IPv4, TCP/IPv4, UDP/IPv6 และ TCP/IPv6 เพื่อเพิ่มโอกาสที่การเชื่อมต่อจะสําเร็จ

ความละเอียดวิดีโอที่รองรับ:

• ขั้นต่ํา: 480p
• สูงสุด: 1080p

ตัวแปลงรหัสวิดีโอที่สนับสนุนมีดังนี้

• VP8
• H.264

ตัวแปลงรหัสเสียงที่รองรับมีดังนี้

• Opus (ตัวแปลงรหัสที่ต้องการ)
• G.711/PCMU
• G.722

กลไกการแชร์ทรัพยากรข้ามโดเมน

Cross-Origin Resource Sharing (CORS) เป็นกลไกที่ใช้ส่วนหัว HTTP เพิ่มเติมในการบอกให้เบราว์เซอร์อนุญาตให้เว็บแอปพลิเคชันที่ทํางานในต้นทางเดียวเข้าถึงทรัพยากรที่เลือกไว้จากต้นทางอื่นได้ เซิร์ฟเวอร์ที่โฮสต์ cameraStreamSignalingUrl ควรตอบกลับด้วยส่วนหัวต่อไปนี้

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

ตัวอย่างคําขอและการตอบกลับสัญญาณ

ตัวอย่างต่อไปนี้แสดงคําขอที่ Google ส่งไปยังบริการส่งสัญญาณและการตอบสนองที่สอดคล้องกันไปยัง 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
{}