Google Meet हार्डवेयर यूएसबी वीडियो क्लास एक्सटेंशन यूनिट एपीआई

यह दस्तावेज़, यूएसबी वीडियो क्लास एक्सटेंशन यूनिट (XU) के साथ काम करने वाले एपीआई के बारे में जानकारी देता है. इनका इस्तेमाल, Google Meet कॉन्फ़्रेंस सिस्टम में कैमरे की स्मार्ट सुविधाओं को चालू करने के लिए किया जाता है. इस स्पेसिफ़िकेशन को बनाने का मकसद इन सुविधाओं को चालू करने के तरीकों पर असर डालना है. साथ ही, इससे हमारे पार्टनर के लिए, एसिंक्रोनस स्केलेबिलिटी और टेस्ट को बेहतर बनाया जा सकता है.

यह टेस्ट स्क्रिप्ट आपके लागू करने के तरीके का विश्लेषण और रिपोर्ट करती है. इससे पार्टनर को इस बात की पुष्टि करने में मदद मिलती है कि सभी नियमों का पालन हो रहा है या नहीं.

इस दस्तावेज़ में हुए नए बदलावों के बारे में जानने के लिए, रिलीज़ नोट पर जाएं.

लिटल-एंडियन कन्वेंशन

यूएसबी एक छोटा स्टैंडर्ड है. इस दस्तावेज़ में:

  • मल्टी-बाइट संख्याएं बिग-एंडियन दिखाई देती हैं (और ये लिटिल-एंडियन ट्रांसमिट होती हैं).
  • बाइट कलेक्शन, लिटिल-एंडियन मेमोरी लेआउट में हैं.

उदाहरण के लिए, 0x12345678 और [0x78, 0x56, 0x34, 0x12] एक जैसे हैं.

एक्सटेंशन यूनिट GUID

Meet XU के इस कंट्रोल के स्पेसिफ़िकेशन के साथ काम करने वाली एक्सटेंशन यूनिट को, इस जीयूआईडी का इस्तेमाल करना चाहिए.

एक्सटेंशन यूनिट GUID
सहायक डिवाइस (जैसे, कीबोर्ड, माउस, मॉनिटर, वेबकैम वगैरह) कंट्रोल XU {74D7E924-49C9-4A45-98A3-8A9F60061E83}

सहायक डिवाइस (जैसे, कीबोर्ड, माउस, मॉनिटर, वेबकैम वगैरह) कंट्रोल XU सिलेक्टर

ये तय किए गए सहायक डिवाइस (जैसे, कीबोर्ड, माउस, मॉनिटर, वेबकैम वगैरह) कंट्रोल XU सिलेक्टर हैं.

कंट्रोल सिलेक्टर वैल्यू
GOOGXU_FRAME_STRATEGY 0x01
GOOGXU_REFRAME 0x02
GOOGXU_OCCUPANCY_COUNTING_TOGGLE 0x03
GOOGXU_OCCUPANCY_COUNTING_READ 0x04
GOOGXU_STATUS_INFO 0x05
GOOGXU_STATUS_RESET 0x06
GOOGXU_PRESETS 0x07
GOOGXU_PAN_TILT_ABSOLUTE 0x08
GOOGXU_PAN_TILT_RELATIVE 0x09

कंट्रोल के अनुरोध का टाइप

कंट्रोल से जुड़े अनुरोधों के टाइप के बारे में चैप्टर 4: यूवीसी 1.5 क्लास के बारे में खास जानकारी के तहत क्लास से जुड़ा खास अनुरोध बताया गया है.

कार्रवाई यूवीसी कंट्रोल
GET GET_CUR, GET_MIN, GET_MAX, GET_RES, GET_LEN, GET_INFO, GET_DEF
SET SET_CUR

कैमरा मोड

कैमरा मोड का इस्तेमाल, मीटिंग रूम में मौजूद लोगों को फ़्रेम करने के लिए किया जाता है. ये इनमें से tuple होते हैं:

  • रणनीति (कैमरा व्यू)
  • पूर्वाग्रह (स्पीकर या रूम)
  • फ़ीड (एक या एक से ज़्यादा स्ट्रीम)

हर डाइमेंशन में, नीचे दिए गए सेक्शन में बताई गई वैल्यू हो सकती हैं.

ऑटो-फ़्रेमिंग की रणनीति

सुविधा ब्यौरा
कभी नहीं कैमरे में, सभी ज़रूरी फ़्रेमिंग की सुविधाएं बंद हो जाती हैं. इससे क्लाइंट, PTZ की वैल्यू को अपने हिसाब से कंट्रोल कर सकता है.
ध्यान दें: फ़्रेमिंग की इस रणनीति पर सेट करने पर, कैमरा अपनी मौजूदा पैन, झुका, और ज़ूम स्थिति में ही रहता है.
कंटिन्यूअस फ़्रेमिंग (CAZ) फ़्रेमिंग के आधार पर, कैमरा कमरे में मौजूद लोगों पर लगातार नज़र रखता है.
ध्यान दें: इस मोड में PTZ बंद है.
स्प्लिट फ़्रेम कैमरा ज़रूरत के मुताबिक जितने चाहें उतने वीडियो व्यू बनाता है. ऑटो-फ़्रेमिंग फ़ीड विकल्प के आधार पर, यह उन्हें एक ही स्ट्रीम में टाइल में बना देता है या हर व्यू के लिए अलग-अलग वीडियो स्ट्रीम बनाता है.
ध्यान दें: इस मोड में PTZ बंद है.
डाइनैमिक व्यू एक या उससे ज़्यादा कैमरे, कमरे का बेहतरीन व्यू दिखाने की कोशिश कर रहे हैं. इससे यह तय किया जा सकता है कि कई फ़ीड को एक साथ जोड़ना है या नहीं या मौजूदा कमरे का "दिलचस्प" व्यू देना है या नहीं.
इस व्यू का मकसद, मीटिंग में शामिल होने वाले लोगों को बेहतर तरीके से दिखाना है.
नोट:
  • ज़्यादातर मीटिंग को इस रणनीति का इस्तेमाल करना चाहिए.
  • इस मोड में PTZ को बंद किया जाता है.

ऑटो-फ़्रेमिंग बायस

सुविधा ब्यौरा
हाई-स्टेक प्रज़ेंटर (स्पीकर ट्रैकिंग) कैमरा, कमरे में बोल रहे व्यक्ति को सबसे अच्छी तरह से फ़्रेम करने की कोशिश करता है.
ऐसी स्थिति में, कैमरे का फ़ोकस प्रज़ेंटर की तरफ़ होना चाहिए. उदाहरण के लिए, किसी बोर्डरूम में प्रज़ेंटेशन देते हुए सीईओ.
साथ मिलकर काम करने के लिए
(चैट रूम की ट्रैकिंग)		 कैमरा, कमरे में मौजूद सभी लोगों को फ़्रेम करने की कोशिश करता है. ऐसी स्थिति में, कैमरे को मीटिंग में हिस्सा लेने वाले हर व्यक्ति के साथ एक जैसे तरीके से पेश आना चाहिए. ज़्यादातर मीटिंग को इस रणनीति का इस्तेमाल करना चाहिए.

ऑटो-फ़्रेमिंग फ़ीड

सुविधा ब्यौरा
सिंगल-स्ट्रीम कैमरा, होस्ट डिवाइस पर एक वीडियो स्ट्रीम भेजता है.
मल्टी-स्ट्रीम
(वर्क-इन-प्रोग्रेस)		 कैमरा, स्ट्रीम को अलग-अलग हिस्सों में बांटता है और होस्ट को भेजने के लिए, कई वीडियो स्ट्रीम बनाता है.
ध्यान दें: इस सुविधा की पूरी जानकारी और उसके काम करने के तरीके की समीक्षा होना बाकी है. जब तक इस दस्तावेज़ में बाद में कोई बदलाव नहीं किया जाता, तब तक यह सुविधा उपलब्ध नहीं है.

ऑटो-फ़्रेमिंग मोड के बिट मैप वैल्यू

None की डिफ़ॉल्ट स्थिति को छोड़कर, जो खाली बाइट कलेक्शन से दिखती है, बाइट कलेक्शन में मौजूद हर बिट एक अलग कैमरा मोड को दिखाता है. यह मोड, ऑटो-फ़्रेमिंग की रणनीति, ऑटो-फ़्रेमिंग के पूर्वाग्रह, और ऑटो-फ़्रेमिंग फ़ीड का खास कॉम्बिनेशन होता है.

बिट इंडेक्स कनाडा स्प्लिट फ़्रेम डाइनैमिक -
स्पीकर दिन 1
-		 -
-		 D5
D6		 सिंगल-स्ट्रीम
मल्टी-स्ट्रीम
रूम दूसरा दिन
-		 D3
D4		 D7
D8		 सिंगल-स्ट्रीम
मल्टी-स्ट्रीम
फ़्रेम मोड फ़्रेम मोड की वैल्यू (सबसे कम ज़रूरी बाइट)
None 0x00
CAZ, Speaker, Single-Stream 0x01
CAZ, Room, Single-Stream 0x02
Split-Frame, Room, Single-Stream 0x04
Split-Frame, Room, Multi-Stream 0x08
Dynamic, Speaker, Single-Stream 0x10
Dynamic, Speaker, Multi-Stream 0x20
Dynamic, Room, Single-Stream 0x40
Dynamic, Room, Multi-Stream 0x80

कंट्रोल: GOOGXU_FRAME_STRATEGY

इस कंट्रोल का इस्तेमाल, ऑटो-फ़्रेमिंग मोड के बिट मैप वैल्यू में बताए गए तरीके से, कैमरे के फ़्रेमिंग मोड पाने या सेट करने के लिए किया जाता है. हर मोड को उनके बिट मैप में बिट के तौर पर दिखाया जाता है. निर्देश GET_RES, शून्य (0) या एक (1) के मान के साथ 8-बाइट लंबा बिटमास्क देता है, ताकि यह पता चल सके कि डिवाइस पर यह सुविधा काम नहीं करती या उसके साथ काम करती है या नहीं. उदाहरण के लिए, अगर किसी कैमरे में CAZ, Speaker, Single-Stream, Split-Frame, Room, Single-Stream, और Dynamic, Room, Multi-Stream काम करता है, लेकिन किसी दूसरे मोड पर यह काम नहीं करता, तो GET_RES को 0x000000000000000085 के बाद सात बाइट के बाद दिखना चाहिए.0b10000101

निर्देश SET_CUR का इस्तेमाल बिटमैप भेजने के लिए किया जाता है. इससे कैमरे को यह पता चलता है कि SINGLE कैमरा मोड चालू करना है या नहीं.

कंट्रोल सिलेक्टर 1
कार्रवाई GET / SET
wLength 8
ऑफ़सेट फ़ील्ड साइज़ वैल्यू ब्यौरा
0 bActiveMode 8 बिट मैप ऐक्टिव कैमरा मोड सेट करना या वापस करना
ध्यान दें:

अनुरोध किस तरह के हो सकते हैं, इसकी जानकारी नीचे दी गई है:

ऑफ़सेट 0 ब्यौरा
GET_CUR ऐक्टिव फ़्रेमिंग कैमरा मोड चालू करें
GET_MIN कैमरे के हिसाब से
GET_MAX कैमरे के हिसाब से
GET_RES काम करने वाले कैमरा मोड का 8-बाइट लंबा बिटमास्क देता है
GET_LEN 0x0008 लंबाई
GET_INFO 0x0 अरब अपने-आप अपडेट करें / लिखें / पढ़ें
GET_DEF 0x00 0x00 0x00 0x00
0x00 0x00 0x00 0x00		 डिफ़ॉल्ट वैल्यू
SET_CUR ऐक्टिव फ़्रेमिंग कैमरा मोड सेट करें

कंट्रोल: GOOGXU_REFRAME

इस कंट्रोल का इस्तेमाल वन-शॉट फ़्रेमिंग को ट्रिगर करने के लिए किया जाता है. इसे OTAZ भी कहा जाता है. जब OTAZ ट्रिगर होता है, तो कैमरे का व्यू अपने-आप में सबसे अच्छी तरह से दिखता है. इसके बाद, क्लाइंट को PTZ वैल्यू को कंट्रोल करने की सुविधा फिर से मिल जाती है. अगर एक शॉट में फ़्रेमिंग की सुविधा काम नहीं करती है, तो कैमरे को यह सेटिंग तय नहीं करनी चाहिए.

कंट्रोल सिलेक्टर 2
कार्रवाई SET
wLength 1
ऑफ़सेट फ़ील्ड साइज़ वैल्यू ब्यौरा
0 bReframe 1 नंबर 0x01 रीफ़्रेम करने का अनुरोध लागू करें

अनुरोध किस तरह के हो सकते हैं, इसकी जानकारी नीचे दी गई है:

ऑफ़सेट 0 ब्यौरा
GET_MIN 0x00
GET_MAX 0x01
GET_RES 0x01
GET_LEN 0x0001
GET_INFO 0x02 सिर्फ़ लिखने के लिए
GET_DEF 0x00
SET_CUR वन-शॉट फ़्रेमिंग के लिए अनुरोध सेट करें

मेहमानों की संख्या की गिनती

व्यस्तता की गिनती (ओसी) एक ऐसी सुविधा है जिसका इस्तेमाल, कैमरे के क्रॉप किए गए व्यू के बावजूद, मीटिंग रूम में हिस्सा लेने वाले लोगों की संख्या का अनुमान लगाने के लिए किया जाता है.

इस टेबल में दिखाया गया है कि ओसी कंट्रोल कैसा काम करते हैं और कैमरा वीडियो स्ट्रीम और कैमरा एलईडी इंडिकेटर के साथ उनका इंटरैक्शन कैसा होगा.

जब व्यस्तता की गिनती यह हो और कैमरे की वीडियो स्ट्रीम: कैमरे का एलईडी इंडिकेटर GOOGXU_OCCUPANCY_COUNTING_TOGGLE GET_CUR होना चाहिए GOOGXU_OCCUPANCY_COUNTING_READ GET_CUR होना चाहिए
चालू की गई स्ट्रीम नहीं किया जा रहा है और म्यूट नहीं किया गया है चालू करें 0x01 कैमरे के सभी फ़ील्ड ऑफ़ व्यू में मौजूद लोगों की संख्या.
चालू की गई स्ट्रीमिंग चालू करें 0x01 कैमरे के सभी फ़ील्ड ऑफ़ व्यू में मौजूद लोगों की संख्या.
चालू की गई म्यूट कर दिया गया है बंद करें 0x01 जिन ऐप्लिकेशन की सूचनाएं फ़िलहाल बंद की गई हैं
जिन ऐप्लिकेशन की सूचनाएं फ़िलहाल बंद की गई हैं स्ट्रीम नहीं किया जा रहा है और म्यूट नहीं किया गया है बंद करें 0x00 जिन ऐप्लिकेशन की सूचनाएं फ़िलहाल बंद की गई हैं
जिन ऐप्लिकेशन की सूचनाएं फ़िलहाल बंद की गई हैं स्ट्रीमिंग चालू करें 0x00 जिन ऐप्लिकेशन की सूचनाएं फ़िलहाल बंद की गई हैं
जिन ऐप्लिकेशन की सूचनाएं फ़िलहाल बंद की गई हैं म्यूट कर दिया गया है बंद करें 0x00 जिन ऐप्लिकेशन की सूचनाएं फ़िलहाल बंद की गई हैं

कंट्रोल: GOOGXU_OCCUPANCY_COUNTING_TOGGLE

इस कंट्रोल का इस्तेमाल इस सुविधा को चालू या बंद करने के लिए किया जाता है, ताकि मीटिंग रूम में मेहमानों की संख्या तय की जा सके. वैल्यू को शून्य (0) पर सेट करने से यह सुविधा बंद हो जाती है और एक (1) वैल्यू चालू हो जाती है. अगर यह सुविधा काम नहीं करती है, तो कैमरे को यह कंट्रोल नहीं देना चाहिए.

कंट्रोल सिलेक्टर 3
कार्रवाई GET / SET
wLength 1
ऑफ़सेट फ़ील्ड साइज़ वैल्यू ब्यौरा
0 bOccupancy 1 बूलियन व्यस्तता की गिनती का फ़ंक्शन सेट करें
0x00 फ़ंक्शन बंद करें
0x01 फ़ंक्शन चालू करें

अनुरोध किस तरह के हो सकते हैं, इसकी जानकारी नीचे दी गई है:

ऑफ़सेट 0 ब्यौरा
GET_CUR अगर व्यस्तता की गिनती चालू है, तो पेज पर वापस जाएं
GET_MIN 0x00
GET_MAX 0x01
GET_RES 0x01
GET_LEN 0x0001
GET_INFO 0x0 अरब अपने-आप अपडेट करें / लिखें / पढ़ें
GET_DEF 0x00
SET_CUR व्यस्तता की गिनती करने की सुविधा को चालू या बंद करें

कंट्रोल: GOOGXU_OCCUPANCY_COUNTING_READ

इस कंट्रोल का इस्तेमाल, मीटिंग रूम में शामिल लोगों की संख्या को पढ़ने के लिए किया जाता है. ऐसा तब किया जाता है, जब कैमरे से व्यस्तता की गिनती करने की सुविधा चालू होती है. अगर यह सुविधा बंद है, तो कैमरा इस कंट्रोल को बंद कर देगा. अगर व्यस्तता की गिनती करने की सुविधा काम नहीं करती है, तो कैमरे को यह कंट्रोल नहीं देना चाहिए.

कंट्रोल सिलेक्टर 4
कार्रवाई GET
wLength 2
ऑफ़सेट फ़ील्ड साइज़ वैल्यू ब्यौरा
0 bNumPeople 2 नंबर मीटिंग में शामिल उन लोगों की संख्या जिनका पता लगाया गया है. (केवल पठन)

अनुरोध किस तरह के हो सकते हैं, इसकी जानकारी नीचे दी गई है:

ऑफ़सेट 0 ब्यौरा
GET_CUR बुकिंग के बाद मिले लोगों की संख्या
GET_MIN 0x0000
GET_MAX 0x00FF
GET_RES 0x0001
GET_LEN 0x0002
GET_INFO 0x09 अपने-आप अपडेट करें / पढ़ें
GET_DEF 0x0000

डिवाइस की टेलीमेट्री और ऐप्लिकेशन की परफ़ॉर्मेंस से जुड़ी जानकारी

इन कंट्रोल का मकसद, Meet हार्डवेयर का इस्तेमाल करके डीबग करने के बेहतर तरीकों को बढ़ावा देना है. आम तौर पर, ये उपयोगकर्ताओं को नहीं दिखते.

कंट्रोल: GOOGXU_STATUS_INFO

इस कंट्रोल का इस्तेमाल, होस्ट कैमरे से जानकारी के बारे में क्वेरी करने के लिए किया जाता है, ताकि डीबग करने के लिए पार्टनर के साथ उसे शेयर किया जा सके.

कंट्रोल सिलेक्टर 5
कार्रवाई GET
wLength 8
ऑफ़सेट फ़ील्ड साइज़ वैल्यू ब्यौरा
0 bNumCameras 1 नंबर मुख्य डिवाइस से जुड़े अतिरिक्त कैमरों की संख्या.
1 bIsMoving 1 बिट मैप जब कैमरा कुछ समय से इस्तेमाल न किया जा रहा हो, तब वैल्यू 0 होती है और जब कैमरा चालू रहता है, तो वैल्यू शून्य नहीं होती. वेंडर, अलग-अलग ऐक्सिस या मोटर को अलग-अलग बिट पर मैप कर सकते हैं.
2 Undef 6 तय नहीं किया गया आने वाले समय में भी प्लान की अवधि बढ़ाई जाएगी.

अनुरोध किस तरह के हो सकते हैं, इसकी जानकारी नीचे दी गई है:

ऑफ़सेट 0 1 2 ब्यौरा
GET_MIN 0x00 0x00 0x00 0x00 0x00
0x00 0x00 0x00
GET_MAX 0xFF 0xFF 0xFF 0xFF 0xFF
0xFF 0xFF 0xFF
GET_RES 0x01 0x01 0x01 0x00 0x00
0x00 0x00 0x00
GET_LEN 0x08 0x00 0x0008
GET_INFO 0x09 अपने-आप अपडेट करें / पढ़ें
GET_DEF 0x00 0x00 0x00 0x00 0x00
0x00 0x00 0x00

कंट्रोल: GOOGXU_STATUS_RESET

इस कंट्रोल का इस्तेमाल, कैमरे को रीसेट करने का अनुरोध करने के लिए किया जाता है. एक (1) की वैल्यू सेट करने पर, कैमरे को रीसेट करने का अनुरोध मिलता है. अगर पिछली बार रीसेट किए जाने के बाद कैमरे को रीस्टार्ट करने का कोई अनुरोध नहीं किया गया है, तो कैमरा शून्य (0) दिखाता है. अगर यह रीसेट हो रहा है, तो दूसरा अनुरोध नहीं किया गया है. रीसेट करने का तरीका वही है जो हार्डवेयर फिर से कनेक्ट होता है. यह खुद से चलने वाले डिवाइस के लिए फ़ायदेमंद होता है, जहां यूएसबी-डिसकनेक्ट को हॉटप्लग के एम्युलेट करने के लिए मजबूर नहीं किया जा सकता.

कंट्रोल सिलेक्टर 6
कार्रवाई GET / SET
wLength 1
ऑफ़सेट फ़ील्ड साइज़ वैल्यू ब्यौरा
0 bResetRequest 1 बूलियन होस्ट और कनेक्ट किए गए कैमरों को रीसेट करने का अनुरोध करें.अगर पिछली बार रीसेट करने के बाद जारी किया गया अनुरोध रीसेट किया जाता है, तो
0x01 दिखाता है, नहीं तो 0x00 दिखाता है.

अनुरोध किस तरह के हो सकते हैं, इसकी जानकारी नीचे दी गई है:

ऑफ़सेट 0 ब्यौरा
GET_MIN 0x00
GET_MAX 0x01
GET_RES 0x01
GET_LEN 0x0001
GET_INFO 0x03 लिखें / पढ़ें
GET_DEF 0x00

PTZ प्रीसेट

इसका इस्तेमाल, कैमरे के फ़ील्ड ऑफ़ व्यू को पहले से सेट किए गए क्रम में कॉन्फ़िगर करने और पहले जैसा करने के लिए किया जाता है.

कंट्रोल: GOOGXU_PRESETS

इस कंट्रोल का इस्तेमाल, कैमरे के पैन, टिल्ट, और ज़ूम (PTZ) की वैल्यू को पहले से तय कॉन्फ़िगरेशन पर सेट करने के लिए किया जाता है.

Preset Action का इस्तेमाल, किसी निर्देश की कार्रवाई बताने के लिए किया जाता है. एक (1) की वैल्यू सेट करने का इस्तेमाल, मौजूदा पैन, टिल्ट, और ज़ूम वैल्यू को दिए गए प्रीसेट इंडेक्स से मैप करने के लिए किया जाता है. दो (2) की वैल्यू पर सेट करने से, कैमरे के पैन, टिल्ट, और ज़ूम को, दिए गए इंडेक्स या डिफ़ॉल्ट फ़ैक्ट्री निर्देशांक (अगर पहले मैप न किए गए हैं) के लिए पहले मैप की गई वैल्यू में बदल जाना चाहिए. तीन (3) की वैल्यू सेट करने से, इंडेक्स फ़ैक्ट्री डिफ़ॉल्ट निर्देशांक पर रीसेट हो जाता है.

Preset Index का इस्तेमाल, इंडेक्स पर मैप किए गए PTZ निर्देशांक तय करने के लिए किया जाता है. शून्य (0) के Preset index को घर के निर्देशांक पर मैप किया जाता है और यह GOOGXU_FRAME_STRATEGY को NONE पर सेट करने पर कैमरे के वेक पर डिफ़ॉल्ट स्थिति होनी चाहिए.

कंट्रोल सिलेक्टर 7
कार्रवाई SET
wLength 2
ऑफ़सेट फ़ील्ड साइज़ वैल्यू ब्यौरा
0 bPresetAction 1 नंबर 0x01: पहले से सेट किए गए तापमान को सेव करें
0x02: पहले से सेट किए गए तापमान को पहले जैसा करें
0x03: प्रीसेट को डिफ़ॉल्ट पर रीसेट करें. (डिफ़ॉल्ट एक मान्य प्रीसेट निर्देशांक होना चाहिए.)
1 bPresetIndex 1 नंबर ऐक्टिव प्रीसेट इंडेक्स. 0~N-1
जहां 0 को कैमरा चालू होने की डिफ़ॉल्ट स्थिति माना जाता है और N-1, प्रीसेट की संख्या के लिए वेंडर का तय किया गया कॉन्सटेंट है.

अनुरोध किस तरह के हो सकते हैं, इसकी जानकारी नीचे दी गई है:

ऑफ़सेट 0 1 ब्यौरा
GET_MIN 0x00 0x00
GET_MAX 0x03 N-1 ज़्यादा से ज़्यादा N प्रीसेट इस्तेमाल किए जा सकते हैं
GET_RES 0x01 0x01
GET_LEN 0x02 0x00 0x0002
GET_INFO 0x02 सिर्फ़ लिखने के लिए
GET_DEF 0x00 0x00

पैन और झुकाएं सहायक मैपिंग

कुछ कैमरों में खास कॉम्पोनेंट होते हैं, जैसे कि मैकेनिकल कैमरों के लिए मोटर, जिनमें पैन और टिल्ट टू फ़ंक्शन के लिए, स्टैंडर्ड V4L2 कंट्रोल के साथ XU निर्देशों की मैपिंग की ज़रूरत होती है.

ये कंट्रोल यूवीसी स्पेसिफ़िकेशन दस्तावेज़ में दिए गए पैन और टिल्ट के पूरे और रिलेटिव कंट्रोल की तरह दिखते हैं. इससे होस्ट डिवाइसों को इन कंट्रोल को सही तरीके से मैप करने का एक स्टैंडर्ड तरीका मिलता है.

कंट्रोल: GOOGXU_PAN_TILT_ABSOLUTE

पैन और टिल्ट के लिए सहायक मैपिंग कंट्रोल के बारे में चैप्टर 4: क्लास के हिसाब से अनुरोध, यूवीसी 1.5 क्लास की खास बातों का सेक्शन 4.2.2.1.14 पैनटिल्ट (निरपेक्ष) कंट्रोल बताया गया है.

कंट्रोल सिलेक्टर 8
कार्रवाई GET/SET
wLength 8
ऑफ़सेट फ़ील्ड साइज़ वैल्यू ब्यौरा
0 dwPanAbsolute 4 हस्ताक्षर किया गया नंबर दिए गए पैन (ऐब्सलूट) कंट्रोल के एट्रिब्यूट के लिए सेटिंग.
4 dwTiltAbsolute 4 हस्ताक्षर किया गया नंबर पते के आधार पर झुकाए गए (ऐब्सलूट) कंट्रोल के एट्रिब्यूट के लिए सेटिंग.

अनुरोध किस तरह के हो सकते हैं, इसकी जानकारी नीचे दी गई है:

ऑफ़सेट 0 4 ब्यौरा
GET_MIN कैमरे के हिसाब से
GET_MAX कैमरे के हिसाब से
GET_RES कैमरे के हिसाब से
GET_LEN 0x0008
GET_INFO 0x0 अरब अपने-आप अपडेट करें / लिखें / पढ़ें
GET_DEF 0x00000000 0x00000000

कंट्रोल: GOOGXU_PAN_TILT_RELATIVE

पैन और टिल्ट के लिए सहायक मैपिंग कंट्रोल के बारे में चैप्टर 4: क्लास के हिसाब से अनुरोध, यूवीसी 1.5 क्लास के स्पेसिफ़िकेशन का कंट्रोल सेक्शन 4.2.2.1.15 पैन टिल्ट (सापेक्ष) किया गया है.

कंट्रोल सिलेक्टर 9
कार्रवाई GET/SET
wLength 4
ऑफ़सेट फ़ील्ड साइज़ वैल्यू ब्यौरा
0 bPanRelative 1 हस्ताक्षर किया गया नंबर दिए गए पैन (रिलेटिव) कंट्रोल के एट्रिब्यूट की सेटिंग:
0: रोकें
1: घड़ी की दिशा में जाना
0xFF: घड़ी की उलटी दिशा में चलना
1 bPanSpeed 1 नंबर पैन को घुमाने की स्पीड.
2 bTiltRelative 1 हस्ताक्षर किया गया नंबर बताए गए झुकाएं (सापेक्ष) कंट्रोल के एट्रिब्यूट के लिए सेटिंग:
0: रोकें
1: इमेज प्लेन को ऊपर की ओर पॉइंट करें
0xFF: इमेज प्लेन को नीचे की ओर पॉइंट करें
3 bTiltSpeed 1 नंबर झुकाने की गतिविधि की स्पीड.

इस तरह के अनुरोध का इस्तेमाल किया जा सकता है:>

ऑफ़सेट 0 1 2 3 ब्यौरा
GET_MIN कैमरे के हिसाब से
GET_MAX कैमरे के हिसाब से
GET_RES कैमरे के हिसाब से
GET_LEN 0x04 0x00 0x0004
GET_INFO 0x0 अरब अपने-आप अपडेट करें / लिखें / पढ़ें
GET_DEF 0x00 0x00 0x00 0x00

प्रॉडक्ट के बारे में जानकारी

इन प्रॉडक्ट की जानकारी में, इस दस्तावेज़ के हर बदलाव में हुए सुधार और नई सुविधाओं को दिखाया जाता है.

15 नवंबर, 2023

मान्य फ़्रेमिंग मोड की जांच करने और उन्हें समझने के लिए, test script को अपडेट किया गया. बाइट के प्रतिनिधित्व को बेहतर तरीके से समझाया गया.

21 जुलाई, 2023

पार्टनर के लिए test script जोड़ी गई, ताकि इस स्पेसिफ़िकेशन के मुताबिक लागू किए जाने की पुष्टि की जा सके.

25 मई, 2023

प्रीसेट की संख्या के बारे में GOOGXU_PRESETS नोट को ठीक किया गया. यह N होना चाहिए, न-1.

17 अप्रैल, 2023

शुरुआती रिलीज़.