स्मार्ट होम कैमरा स्ट्रीम की विशेषता का स्कीमा

action.devices.traits.CameraStream - इस ट्रैट में, किसी डिवाइस की कैमरा स्ट्रीम को कंट्रोल करने का तरीका बताया गया है.

यह एट्रिब्यूट उन डिवाइसों के लिए है जिनमें स्मार्ट डिसप्ले, Chromecast की सुविधा वाले डिवाइसों या स्मार्टफ़ोन पर वीडियो फ़ीड स्ट्रीम करने की सुविधा होती है. ज़्यादातर, ये सिक्योरिटी कैमरे या बेबी कैमरे होते हैं. हालांकि, यह सुविधा उन ज़्यादा जटिल डिवाइसों पर भी लागू होती है जिनमें कैमरा होता है. जैसे, वीडियो कॉन्फ़्रेंसिंग डिवाइस या कैमरे वाला वैक्यूम रोबोट.

डिवाइस के एट्रिब्यूट

इस विशेषता वाले डिवाइस, SYNC ऑपरेशन के हिस्से के तौर पर, इन एट्रिब्यूट की जानकारी दे सकते हैं. SYNC इंटेंट को मैनेज करने के बारे में ज़्यादा जानने के लिए, इंटेंट पूरा करना लेख पढ़ें.

उदाहरण

एक से ज़्यादा प्रोटोकॉल के साथ काम करने वाला कैमरा, जिसके लिए पुष्टि करने का टोकन ज़रूरी नहीं है.

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

ऐसा कैमरा जो किसी एक प्रोटोकॉल के साथ काम करता हो और जिसके लिए पुष्टि करने वाला टोकन ज़रूरी हो.

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

स्ट्रीमिंग के लिए इस्तेमाल किए जा सकने वाले प्रोटोकॉल

यह ट्रैट इन स्ट्रीमिंग प्रोटोकॉल के साथ काम करता है:

• webrtc: WebRTC
• hls: एचटीटीपी लाइव स्ट्रीमिंग
• dash: डाइनैमिक अडैप्टिव स्ट्रीमिंग ओवर एचटीटीपी
• smooth_stream: स्मूद स्ट्रीमिंग
• progressive_mp4: प्रोग्रेसिव MP4 (ज़्यादातर क्लिप के लिए इस्तेमाल किया जाता है)

Cast डिवाइसों (Chromecast, स्मार्ट डिसप्ले, और Chromecast की सुविधा वाले स्मार्ट टीवी) पर hls,dash,smooth_stream, और progressive_mp4 प्रोटोकॉल स्ट्रीम करने पर, स्ट्रीम को प्रोसेस करने और डिवाइस पर रेंडर करने के लिए, एक Cast वेब रिसीवर लॉन्च किया जाता है. हमारा सुझाव है कि डेवलपर एक कस्टम वेब रिसीवर बनाए, ताकि वह डिबगिंग टूल का ऐक्सेस चालू कर सके, प्लेयर के व्यवहार को पसंद के मुताबिक बना सके, यूज़र इंटरफ़ेस (यूआई) की ब्रैंडिंग को पसंद के मुताबिक बना सके, और आंकड़ों को शामिल कर सके. कस्टम रिसीवर का इस्तेमाल करने और डिफ़ॉल्ट रिसीवर का इस्तेमाल करने से ऑप्ट आउट करने के लिए, EXECUTE रिस्पॉन्स के cameraStreamReceiverAppId फ़ील्ड में, रिसीवर का वह ऐप्लिकेशन आईडी सेट करें जो अपने Cast ऐप्लिकेशन को रजिस्टर करने पर जनरेट होता है.

कस्टम वेब रिसीवर ऐप्लिकेशन के बारे में ज़्यादा जानने के लिए, डेवलपर की साइट पर मौजूद गाइड पर जाएं.

डिवाइस की स्थितियां

कोई नहीं.

डिवाइस के लिए निर्देश

इस विशेषता वाले डिवाइस, EXECUTE ऑपरेशन के तहत, इन निर्देशों का जवाब दे सकते हैं. EXECUTE इंटेंट को मैनेज करने के बारे में ज़्यादा जानने के लिए, इंटेंट पूरा करना लेख पढ़ें.

action.devices.commands.GetCameraStream

पैरामीटर

नतीजे

WebRTC के अलावा अन्य नतीजे

WebRTC के नतीजे

उदाहरण

सामने के दरवाज़े पर लगे कैमरे का वीडियो दिखाओ (डिफ़ॉल्ट रूप से सेट किया गया Cast रिसीवर).

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

सामने के दरवाज़े पर लगे कैमरे का वीडियो दिखाओ (कस्टम Cast रिसीवर).

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

डिवाइस से जुड़ी गड़बड़ियां

WebRTC प्रोटोकॉल की खास बातें

WebRTC का इस्तेमाल करने के फ़ायदे: कम लेटेंसी और एकतरफ़ा बातचीत. WebRTC, POST बॉडी और JSON फ़ॉर्मैट में रिस्पॉन्स के साथ POST तरीके का इस्तेमाल करता है.

फ़िलहाल, WebRTC की सुविधा Google Nest स्मार्ट डिसप्ले और Chromecast with Google TV डिवाइसों पर काम करती है.

इस सेक्शन में, WebRTC स्ट्रीम प्रोटोकॉल का इस्तेमाल करने से जुड़ी ज़रूरी शर्तों के बारे में बताया गया है.

WebRTC से जुड़ी ज़रूरी शर्तें और सुझाव

• फ़िलहाल, Google एकतरफ़ा (हफ़ डुपलेक्स) कम्यूनिकेशन के साथ काम करता है.
• आपके पास बंडलिंग और rtcp-mux की सुविधा होनी चाहिए.
• आपको (D)TLS 1.2 या इसके बाद के वर्शन का इस्तेमाल करना होगा.
• Trickle ICE काम नहीं करता. एसडीपी भेजने से पहले, सभी आईसीई उम्मीदवारों की जानकारी इकट्ठा कर ली जानी चाहिए.
• हमारा सुझाव है कि आप UDP/IPv4, TCP/IPv4, UDP/IPv6, और TCP/IPv6 ICE उम्मीदवारों को शामिल करें, ताकि कनेक्शन की संभावना बढ़ाई जा सके.

इस्तेमाल किए जा सकने वाले वीडियो रिज़ॉल्यूशन:

• कम से कम: 480 पिक्सल
• ज़्यादा से ज़्यादा: 1080 पिक्सल

काम करने वाले वीडियो कोडेक:

• VP8
• H.264

इसके साथ काम करने वाले ऑडियो कोडेक:

• Opus (पसंदीदा कोडेक)
• G.711/PCMU
• G.722

क्रॉस-ओरिजिन रिसॉर्स शेयरिंग

क्रॉस-ऑरिजिन रिसॉर्स शेयरिंग (सीओआरएस) एक ऐसा तरीका है जो अतिरिक्त एचटीटीपी हेडर का इस्तेमाल करके, ब्राउज़र को यह बताता है कि एक ऑरिजिन पर चल रहे वेब ऐप्लिकेशन को, किसी दूसरे ऑरिजिन से चुने गए रिसॉर्स ऐक्सेस करने की अनुमति दें. 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
{}