Google Meet হার্ডওয়্যার ইউএসবি ভিডিও ক্লাস এক্সটেনশন ইউনিট এপিআই

এই ডকুমেন্টটি ইন্টেলিজেন্ট ক্যামেরা ফিচার চালু করতে Google Meet কনফারেন্স সিস্টেম দ্বারা ব্যবহৃত সমর্থিত USB ভিডিও ক্লাস এক্সটেনশন ইউনিট (XU) API-এর রূপরেখা দেয়। এই স্পেসিফিকেশন তৈরির উদ্দেশ্য হল এই বৈশিষ্ট্যগুলিকে সক্ষম করার অনুশীলনগুলিকে প্রভাবিত করা এবং আমাদের অংশীদারদের জন্য আরও ভাল অ্যাসিঙ্ক্রোনাস স্কেলেবিলিটি এবং পরীক্ষার অনুমতি দেওয়া।

এই নথিতে সর্বশেষ পরিবর্তন সম্পর্কে বিশদ বিবরণের জন্য, রিলিজ নোটে যান।

পরীক্ষার সুবিধা

অংশীদারদের এই স্পেসিফিকেশনের সাথে সম্মতি যাচাই করতে সহায়তা করার জন্য, আমরা ডেভেলপার মোডে সেট করা Chromebox-এর জন্য-মিটিং ডিভাইসগুলিতে একটি পরীক্ষার সুবিধা প্রদান করি। ফাইল সিস্টেমে লেখা সক্রিয় করুন। নিম্নলিখিত লাইনগুলি /etc/chrome_dev.conf এ যোগ করুন:

--enable-logging
--log-level=0

ডিভাইসটি পুনরায় চালু করুন, ক্যামেরা এবং একটি USB কীবোর্ড সংযোগ করুন, Ctrl-Alt-X টিপুন এবং সক্রিয় ক্যামেরার বিশেষ সম্মতি অনুশীলন করা হবে এবং /home/chronos/user/log/chrome এ লগ করা হবে৷

লিটল-এন্ডিয়ান কনভেনশন

ইউএসবি একটি সামান্য-এন্ডিয়ান স্ট্যান্ডার্ড। এই নথির মধ্যে:

  • মাল্টি-বাইট সংখ্যা বড়-এন্ডিয়ান দেখায় (এবং ছোট-এন্ডিয়ান প্রেরণ করা হয়)।
  • বাইট অ্যারে লিটল-এন্ডিয়ান মেমরি লেআউটে রয়েছে।

উদাহরণস্বরূপ, 0x12345678 একই [0x78, 0x56, 0x34, 0x12] ।

এক্সটেনশন ইউনিট GUID

এই Meet XU কন্ট্রোল স্পেসিফিকেশন সমর্থনকারী এক্সটেনশন ইউনিটগুলিকে অবশ্যই এই GUID ব্যবহার করতে হবে।

এক্সটেনশন ইউনিট 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
GOOGXU_SATELLITE_INFO 0x0A

নিয়ন্ত্রণ অনুরোধের ধরন

কন্ট্রোল রিকোয়েস্টের ধরনগুলি অধ্যায় 4-এ সংজ্ঞায়িত করা হয়েছে: UVC 1.5 ক্লাস স্পেসিফিকেশনের ক্লাস স্পেসিফিক রিকোয়েস্ট।

অপারেশন UVC নিয়ন্ত্রণ
GET GET_CUR , GET_MIN , GET_MAX , GET_RES , GET_LEN , GET_INFO , GET_DEF
SET SET_CUR

ক্যামেরা মোড

ক্যামেরা মোডগুলি একটি মিটিং রুমে ব্যক্তিদের ফ্রেম করার জন্য ব্যবহার করা হয় এবং এর tuple হল:

  • কৌশল (ক্যামেরা ভিউ)
  • পক্ষপাত (স্পিকার বা রুম)
  • ফিড (একক বা একাধিক স্ট্রিম)

প্রতিটি মাত্রা নিম্নলিখিত বিভাগে বর্ণিত মান নিতে পারে।

অটো-ফ্রেমিং কৌশল

"কোনটিই" ছাড়া সমস্ত স্বয়ংক্রিয় ফ্রেমিং মোডে ম্যানুয়াল প্যান, টিল্ট এবং জুম অক্ষম করা আছে৷

বৈশিষ্ট্য বর্ণনা
কোনোটিই নয় ক্যামেরা সমস্ত বুদ্ধিমান ফ্রেমিং বৈশিষ্ট্যগুলিকে অক্ষম করে এবং ক্লায়েন্টকে PTZ মানগুলিকে অবাধে নিয়ন্ত্রণ করতে দেয়।
দ্রষ্টব্য: এই ফ্রেমিং কৌশলে সেট করা হলে, ক্যামেরাটি তার বর্তমান প্যান, কাত এবং জুম অবস্থানে থাকে।
ক্রমাগত ফ্রেমিং (CAZ) ফ্রেমিং পক্ষপাতের উপর ভিত্তি করে, ক্যামেরা ক্রমাগত রুমের লোকেদের ট্র্যাক করে।
বিভক্ত ফ্রেম ক্যামেরা প্রয়োজন অনুযায়ী অনেক ভিডিও ভিউ তৈরি করে। স্বয়ংক্রিয়-ফ্রেমিং ফিড বিকল্পের উপর ভিত্তি করে, এটি হয় সেগুলিকে একটি একক স্ট্রীমে টাইলগুলিতে রচনা করে বা প্রতিটি দৃশ্যের জন্য পৃথক ভিডিও স্ট্রিম তৈরি করে।
ডাইনামিক ভিউ এক বা একাধিক ক্যামেরা ঘরের সেরা দৃশ্য প্রদান করার চেষ্টা করে। এটি একাধিক ফিডকে একটিতে সংমিশ্রিত করবে কিনা বা বর্তমান রুমের একটি "আকর্ষণীয়" দৃশ্য প্রদান করবে কিনা তা নির্ধারণ করতে পারে।
এই দৃষ্টিভঙ্গির উদ্দেশ্য হল ইন-রুম অংশগ্রহণকারীদের কলে সবচেয়ে ন্যায়সঙ্গত দৃষ্টিভঙ্গি প্রদান করা।
বিক্রেতা-পছন্দের ক্যামেরা সিস্টেম রুমের সেরা দৃশ্য নির্ধারণ করতে তার নিজস্ব যুক্তি ব্যবহার করে। অন্তর্নিহিত ফ্রেমিং কৌশল নোটিশ ছাড়াই পরিবর্তন সাপেক্ষে. উদাহরণস্বরূপ, যদি রুমে লোকের সংখ্যা পরিবর্তিত হয়, বা ক্যামেরা "হাই-স্টেক প্রেজেন্টার" বনাম একটি "সহযোগিতা" মিটিং এর মধ্যে পার্থক্য সনাক্ত করতে পারে, তাহলে সিস্টেমটি ফ্রেমিং কৌশলকে মানিয়ে নিতে বা পরিবর্তন করতে পারে যেভাবে এটি উপযুক্ত মনে করে। এই মোড এই মোডে থাকাকালীন, getCur কল করলে VENDOR_PREFERRED ফিরে আসবে, এবং সিস্টেম দ্বারা নির্বাচিত অন্তর্নিহিত ফ্রেমিং মোড নয়৷

অটো-ফ্রেমিং পক্ষপাত

বৈশিষ্ট্য বর্ণনা
হাই-স্টেক উপস্থাপক (স্পীকার ট্র্যাকিং) কক্ষে সক্রিয়ভাবে কথা বলা ব্যক্তিকে ক্যামেরা সবচেয়ে ভালোভাবে ফ্রেম করার চেষ্টা করে।
এই পরিস্থিতিতে, ক্যামেরা উপস্থাপকের দিকে পক্ষপাতিত্ব করা উচিত। উদাহরণস্বরূপ, একটি বোর্ডরুমে সিইও একটি উপস্থাপনা দিচ্ছেন।
সহযোগিতা
(রুম ট্র্যাকিং)		 ক্যামেরা রুমের সমস্ত অংশগ্রহণকারীদের সেরা ফ্রেম করার চেষ্টা করে। এই পরিস্থিতিতে, ক্যামেরার প্রত্যেক অংশগ্রহণকারীর সাথে সমান আচরণ করা উচিত।

অটো-ফ্রেমিং ফিড

বৈশিষ্ট্য বর্ণনা
একক-প্রবাহ ক্যামেরা হোস্ট ডিভাইসে একটি একক ভিডিও স্ট্রিম পাঠায়।
মাল্টি-স্ট্রিম
(কাজ চলছে)		 ক্যামেরা স্ট্রীমকে বিভক্ত করে এবং হোস্টে পাঠানোর জন্য একাধিক ভিডিও স্ট্রিম তৈরি করে।
দ্রষ্টব্য: এই বৈশিষ্ট্যটির সম্পূর্ণ স্পেসিফিকেশন এবং প্রত্যাশিত আচরণ পর্যালোচনা মুলতুবি রয়েছে এবং এই নথির পরবর্তী সংশোধন না হওয়া পর্যন্ত সমর্থিত নয় ।

অটো-ফ্রেমিং মোড বিটম্যাপ মান

একটি খালি বাইট অ্যারে দ্বারা উপস্থাপিত None এর ডিফল্ট অবস্থা ব্যতীত, বাইট অ্যারের প্রতিটি বিট একটি ভিন্ন ক্যামেরা মোড উপস্থাপন করে যা অটো-ফ্রেমিং কৌশল , অটো-ফ্রেমিং বায়াস এবং অটো-ফ্রেমিং ফিডগুলির একটি নির্দিষ্ট সংমিশ্রণ।

অটো-ফ্রেমিং ফিড CAZ স্প্লিট-ফ্রেম গতিশীল বিক্রেতা-পছন্দের অটো-ফ্রেমিং পক্ষপাত
একক-প্রবাহ D1
D2		 -
D3		 D5
D7		 D9 (স্পিকার বা রুম) স্পিকার
রুম
মাল্টি-স্ট্রিম -
-		 -
D4		 D6
D8		 - স্পিকার
রুম
ফ্রেম মোড ফ্রেম মোড মান (সর্বনিম্ন উল্লেখযোগ্য বাইট)
None 0x0000
CAZ, Speaker, Single-Stream 0x0001
CAZ, Room, Single-Stream 0x0002
Split-Frame, Room, Single-Stream 0x0004
Split-Frame, Room, Multi-Stream 0x0008
Dynamic, Speaker, Single-Stream 0x0010
Dynamic, Speaker, Multi-Stream 0x0020
Dynamic, Room, Single-Stream 0x0040
Dynamic, Room, Multi-Stream 0x0080
Vendor-preferred, Single-Stream 0x0100

নিয়ন্ত্রণ: 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 কমান্ড ব্যবহার করা হয় বিটম্যাপ পাঠাতে ক্যামেরাকে জানাতে যে কোন একক ক্যামেরা মোড সক্ষম করতে হবে।

নিয়ন্ত্রণ নির্বাচক 1
অপারেশন GET / SET
wLength 8
অফসেট মাঠ আকার মান বর্ণনা
0 bActiveMode 8 বিটম্যাপ সক্রিয় ক্যামেরা মোড সেট করুন বা ফেরত দিন
নোট:

সমর্থিত অনুরোধ প্রকারের আচরণ নিম্নরূপ:

অফসেট 0 বর্ণনা
GET_CUR সক্রিয় ফ্রেমিং ক্যামেরা মোড পান
GET_MIN ক্যামেরা নির্ভর
GET_MAX ক্যামেরা নির্ভর
GET_RES সমর্থিত ক্যামেরা মোডগুলির একটি 8-বাইট লম্বা বিটমাস্ক প্রদান করে
GET_LEN 0x0008 দৈর্ঘ্য
GET_INFO 0x0B স্বয়ংক্রিয় আপডেট / লিখুন / পড়ুন
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 এক-শট ফ্রেমিংয়ের জন্য অনুরোধ সেট করুন

দখল গণনা

অকুপেন্সি কাউন্টিং (OC) হল একটি বৈশিষ্ট্য যা ক্যামেরার ক্রপ করা ভিউ থাকা সত্ত্বেও মিটিং রুমে অংশগ্রহণকারীদের সংখ্যা অনুমান করতে ব্যবহৃত হয়।

এই টেবিলটি OC কন্ট্রোলের প্রত্যাশিত আচরণ এবং ক্যামেরা ভিডিও স্ট্রীম এবং ক্যামেরা LED সূচকের সাথে তাদের মিথস্ক্রিয়া দেখায়।

যখন দখল গণনা হয় এবং ক্যামেরা ভিডিও স্ট্রিম হল: ক্যামেরা LED ইন্ডিকেটর হতে হবে 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 0x0B স্বয়ংক্রিয় আপডেট / লিখুন / পড়ুন
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 যখন ক্যামেরা নিষ্ক্রিয় থাকে, এবং যখন PTZ মান পরিবর্তন হয় তখন নন-শূন্য। বিক্রেতারা বিভিন্ন অক্ষ বা মোটরকে বিভিন্ন বিটে ম্যাপ করতে বিনামূল্যে।
2 Undef 6 Undef ভবিষ্যতে বাড়ানো হবে।

সমর্থিত অনুরোধ প্রকারের আচরণ নিম্নরূপ:

অফসেট 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_SATELLITE_INFO

এই কন্ট্রোলটি এই ক্যামেরা সিস্টেমের সাথে সংযুক্ত স্যাটেলাইট ডিভাইসগুলিকে জিজ্ঞাসা করতে ব্যবহৃত হয়৷

নিয়ন্ত্রণ নির্বাচক 0x0A
অপারেশন GET
wLength 20
অফসেট মাঠ আকার মান বর্ণনা
0 bSatelliteList 20 বিটম্যাপ সিস্টেমের সাথে সংযুক্ত স্যাটেলাইট প্রকারের তালিকা। চারটি পৃথক 5-বাইট স্লট অন্তর্ভুক্ত। প্রতিটি স্লট নিম্নরূপ বর্ণনা করা হয়েছে:
অফসেট বর্ণনা
0 এই স্যাটেলাইট ধরনের জন্য পরিমাণ.
1-2 এই স্যাটেলাইট টাইপের ভেন্ডর আইডি।
3-4 এই স্যাটেলাইট ধরনের জন্য পণ্য আইডি.

সমর্থিত অনুরোধ প্রকারের আচরণ নিম্নরূপ:

অফসেট 0 বর্ণনা
GET_MIN 0x00 0x00 0x00 0x00 0x00
0x00 0x00 0x00 0x00 0x00
0x00 0x00 0x00 0x00 0x00
0x00 0x00 0x00 0x00 0x00
GET_MAX 0xFF 0xFF 0xFF 0xFF 0xFF
0xFF 0xFF 0xFF 0xFF 0xFF
0xFF 0xFF 0xFF 0xFF 0xFF
0xFF 0xFF 0xFF 0xFF 0xFF
GET_RES 0x00 0x00 0x00 0x00 0x00
0x00 0x00 0x00 0x00 0x00
0x00 0x00 0x00 0x00 0x00
0x00 0x00 0x00 0x00 0x00
GET_LEN 0x14 20 বাইট
GET_INFO 0x09 অটোআপডেট/পড়ুন
GET_DEF 0x00 0x00 0x00 0x00 0x00
0x00 0x00 0x00 0x00 0x00
0x00 0x00 0x00 0x00 0x00
0x00 0x00 0x00 0x00 0x00

নিয়ন্ত্রণ: GOOGXU_STATUS_RESET

এই কন্ট্রোলটি ক্যামেরায় রিসেট করার অনুরোধ জারি করতে ব্যবহৃত হয়। একটি (1) মান সেট করা ক্যামেরাকে রিসেট করার অনুরোধ করে। শেষ রিসেট করার পর থেকে ক্যামেরা রিস্টার্ট করার জন্য কোনো অনুরোধ না থাকলে ক্যামেরাটি শূন্য (0) এবং রিসেট হলে একটি (1) ফেরত দেয়। রিসেট একটি ক্যামেরা রিবুট ট্রিগার আবশ্যক. (এটি স্ব-চালিত ডিভাইসগুলির জন্য প্রয়োজন যেখানে একটি হটপ্লাগ অনুকরণ করতে একটি USB- সংযোগ বিচ্ছিন্ন করা কার্যকর নয়৷)

নিয়ন্ত্রণ নির্বাচক 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 এন সর্বোচ্চ প্রিসেট সমর্থিত
GET_RES 0x01 0x01
GET_LEN 0x02 0x00 0x0002
GET_INFO 0x02 শুধু লিখুন
GET_DEF 0x00 0x00

প্যান এবং টিল্ট অক্জিলিয়ারী ম্যাপিং

কিছু ক্যামেরার বিশেষ উপাদান থাকে, যেমন যান্ত্রিক ক্যামেরার জন্য মোটর বা ডিজিটাল PTZ ক্ষমতা। এগুলোর জন্য, প্যান, টিল্ট এবং জুমের জন্য স্ট্যান্ডার্ড V4L2 কন্ট্রোল ব্যবহার করুন।

নিয়ন্ত্রণ: GOOGXU_PAN_TILT_ABSOLUTE (অপ্রচলিত)

প্যান এবং টিল্ট অক্জিলিয়ারী ম্যাপিং নিয়ন্ত্রণগুলি অধ্যায় 4 এ সংজ্ঞায়িত করা হয়েছে: ক্লাস নির্দিষ্ট অনুরোধ বিভাগ 4.2.2.1.14 প্যানটিল্ট (পরম) UVC 1.5 ক্লাস স্পেসিফিকেশনের নিয়ন্ত্রণ।

নিয়ন্ত্রণ: GOOGXU_PAN_TILT_RELATIVE (অপ্রচলিত)

প্যান এবং টিল্ট অক্জিলিয়ারী ম্যাপিং নিয়ন্ত্রণগুলি অধ্যায় 4 এ সংজ্ঞায়িত করা হয়েছে: ক্লাস নির্দিষ্ট অনুরোধ বিভাগ 4.2.2.1.15 প্যানটিল্ট (আপেক্ষিক) UVC 1.5 ক্লাস স্পেসিফিকেশনের নিয়ন্ত্রণ।

রিলিজ নোট

এই রিলিজ নোটগুলি এই নথির প্রতিটি সংশোধনে উন্নতি এবং নতুন বৈশিষ্ট্যগুলিকে প্রতিফলিত করে৷

জানুয়ারী 27, 2025

  • GOOGXU_FRAME_STRATEGY এ Vendor-preferred ফ্রেমিং কৌশল যোগ করা হয়েছে।
  • নতুন নিয়ন্ত্রণ যোগ করা হয়েছে: GOOGXU_SATELLITE_INFO ।

21 মে, 2024

15 নভেম্বর, 2023

বৈধ ফ্রেমিং মোড চেক এবং ব্যাখ্যা করতে পরীক্ষা স্ক্রিপ্ট আপডেট করা হয়েছে। স্পষ্ট বাইট উপস্থাপনা.

জুলাই 21, 2023

এই স্পেসিফিকেশনের সাথে সম্মতির জন্য বাস্তবায়নকে যাচাই করতে অংশীদারদের জন্য পরীক্ষা স্ক্রিপ্ট যোগ করা হয়েছে।

25 মে, 2023

প্রিসেট সংখ্যা সংক্রান্ত GOOGXU_PRESETS নোট সংশোধন করা হয়েছে। এটি N-1 নয়, N হওয়া উচিত।

এপ্রিল 17, 2023

প্রাথমিক মুক্তি।