ตั้งแต่วันที่ 27 มีนาคม 2025 เป็นต้นไป เราขอแนะนำให้ใช้ android-latest-release แทน aosp-main เพื่อสร้างและมีส่วนร่วมใน AOSP โปรดดูข้อมูลเพิ่มเติมที่หัวข้อการเปลี่ยนแปลงใน AOSP

หน้านี้ได้รับการแปลโดย Cloud Translation API

โปรโตคอล HID ของอุปกรณ์ติดตามการเคลื่อนไหวของศีรษะ
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

โปรโตคอลอุปกรณ์ที่โต้ตอบกับมนุษย์โดยตรง (HID) ของอุปกรณ์ติดตามการเคลื่อนไหวของศีรษะพร้อมใช้งานสำหรับอุปกรณ์ที่ใช้ Android 13 ขึ้นไป ซึ่งช่วยให้อุปกรณ์ติดตามการเคลื่อนไหวของศีรษะเชื่อมต่อกับอุปกรณ์ Android ผ่าน USB หรือบลูทูธ และแสดงในเฟรมเวิร์กและแอป Android ผ่านเฟรมเวิร์กเซ็นเซอร์ โปรโตคอลนี้ใช้สำหรับ กำลังควบคุม เอฟเฟกต์เสียงเสมือนจริง (เสียง 3 มิติ) หน้านี้ใช้คำว่าอุปกรณ์และโฮสต์ตามความหมายของบลูทูธ โดยที่อุปกรณ์หมายถึงอุปกรณ์ติดตามการเคลื่อนไหวของศีรษะ และโฮสต์หมายถึงโฮสต์ Android

ผู้ผลิตอุปกรณ์ต้องกำหนดค่าอุปกรณ์ Android เพื่อเปิดใช้การรองรับโปรโตคอล HID ของอุปกรณ์ติดตามการเคลื่อนไหวของศีรษะ หากต้องการดูข้อมูลโดยละเอียดเพิ่มเติมเกี่ยวกับ โปรดดู เทคโนโลยีเซ็นเซอร์แบบไดนามิก README

หน้านี้ถือว่าคุณคุ้นเคยกับทรัพยากรต่อไปนี้

โครงสร้างระดับบนสุด

เฟรมเวิร์ก Android ระบุว่าอุปกรณ์ติดตามศีรษะเป็นอุปกรณ์ HID

ดูตัวอย่างที่สมบูรณ์ของข้อบ่งชี้ HID ที่ถูกต้องได้ที่ภาคผนวก 1: ตัวอย่างข้อบ่งชี้ HID

ที่ระดับบนสุด อุปกรณ์ติดตามศีรษะคือคอลเล็กชันแอปที่มี Sensors หน้า (0x20) และการใช้งาน Other: Custom (0xE1) ใน คือช่องข้อมูลหลายช่อง (อินพุต) และพร็อพเพอร์ตี้ (ฟีเจอร์)

พร็อพเพอร์ตี้และฟิลด์ข้อมูล

ส่วนนี้จะอธิบายพร็อพเพอร์ตี้และช่องข้อมูลในแอปพลิเคชัน คอลเล็กชันอุปกรณ์ติดตามศีรษะ

พร็อพเพอร์ตี้: คำอธิบายเซ็นเซอร์ (`0x0308`)

พร็อพเพอร์ตี้รายละเอียดเซ็นเซอร์ (0x0308) คือสตริง ASCII (8 บิต) แบบอ่านอย่างเดียว คุณสมบัติที่ต้องมีค่าต่อไปนี้

เครื่องติดตามการเคลื่อนไหวศีรษะเวอร์ชัน 1.0:

#AndroidHeadTracker#1.0

อุปกรณ์ติดตามการเคลื่อนไหวของศีรษะเวอร์ชัน 2.0 (ใช้ได้ใน Android 15 ขึ้นไป) ซึ่งรองรับเสียง LE

#AndroidHeadTracker#2.0#x

x คือจำนวนเต็ม (1, 2, 3) ที่ระบุการขนส่งที่รองรับ ดังนี้

1: ACL
2: ISO
3: ACL + ISO

ไม่มีการสิ้นสุด Null ซึ่งหมายความว่าขนาดทั้งหมดของพร็อพเพอร์ตี้นี้คืออักขระ 8 บิต 23 ตัวสำหรับเวอร์ชัน 1.0

พร็อพเพอร์ตี้นี้ทำหน้าที่เป็นตัวแยกแยะเพื่อหลีกเลี่ยงการทับซ้อนกับเซ็นเซอร์ที่กำหนดเองอื่นๆ

พร็อพเพอร์ตี้: รหัสที่ไม่ซ้ำกันแบบถาวร (`0x0302`)

พร็อพเพอร์ตี้ Persistent Unique ID (0x0302) คืออาร์เรย์แบบอ่านอย่างเดียวที่ 16 รายการละ 8 บิต (ทั้งหมด 128 บิต) คาดว่าไม่มีเครื่องหมายสิ้นสุดที่เป็นค่าว่าง พร็อพเพอร์ตี้นี้ไม่บังคับ

พร็อพเพอร์ตี้นี้อนุญาตอุปกรณ์ติดตามการเคลื่อนไหวศีรษะที่ผสานรวมอยู่ในเสียง อุปกรณ์เพื่ออ้างอิงอุปกรณ์เสียงที่เชื่อมต่ออยู่ ระบบรองรับรูปแบบต่อไปนี้

อุปกรณ์ติดตามการเคลื่อนไหวของศีรษะแบบสแตนด์อโลน

หากไม่มีพร็อพเพอร์ตี้รหัสที่ไม่ซ้ำกันแบบถาวร (0x0302) หรือมีการตั้งค่าเป็นค่า 0 ทั้งหมด หมายความว่าอุปกรณ์ติดตามการเคลื่อนไหวของศีรษะไม่ได้ติดอยู่กับอุปกรณ์เสียงอย่างถาวรและสามารถใช้งานได้แยกกัน เช่น โดยการอนุญาตให้ผู้ใช้เชื่อมโยงอุปกรณ์ติดตามการเคลื่อนไหวของศีรษะกับอุปกรณ์เสียงแยกต่างหากด้วยตนเอง

การอ้างอิงใช้ที่อยู่ MAC ของบลูทูธ

อ็อกเท็ต	0	1	2	3	4	5	6	7	8	9	10	11	12	13	14	15
ค่า	0	0	0	0	0	0	0	0	B	T	MAC ของบลูทูธ

ในรูปแบบนี้ อ็อกเต็ต 8 ตัวแรกต้องเป็น 0 อ็อกเต็ต 8 และ 9 ต้องมีค่า ASCII เป็น B และ T ตามลำดับ และระบบจะตีความอ็อกเต็ต 6 ตัวถัดไปเป็นที่อยู่ MAC ของบลูทูธ โดยสมมติว่าอุปกรณ์ติดตามการเคลื่อนไหวของศีรษะใช้ได้กับอุปกรณ์เสียงที่มีที่อยู่ MAC นี้ ที่อยู่นี้ต้องเป็นที่อยู่ระบุตัวตน แม้ว่าอุปกรณ์จะใช้ที่อยู่ MAC แบบสุ่มเพื่อสร้างการเชื่อมต่อก็ตาม อุปกรณ์แบบ 2 โหมดที่เชื่อมต่อผ่านบลูทูธคลาสสิก (รูปแบบ HID v1.0) และบลูทูธ LE (รูปแบบ HID v2.0) ต้องแสดงตัวบ่งชี้ HID 2 รายการที่มีที่อยู่เดียวกัน อุปกรณ์แบบ 2 โหมดที่มีอุปกรณ์ซ้ายและขวาแยกกันต้องแสดง HID ของบลูทูธ LE โดยใช้อุปกรณ์แบบ 2 โหมดหลักแทนอุปกรณ์รองที่ใช้ LE เท่านั้น

อ้างอิงโดยใช้ UUID

เมื่อใดก็ตามที่ตั้งค่าบิตที่สำคัญที่สุด (MSB) ของอ็อกเท็ต 8 (≥0x80) ฟิลด์ ถูกแปลค่าเป็น UUID ตามที่ระบุไว้ใน RFC-4122 อุปกรณ์เสียงที่เกี่ยวข้องจะให้ UUID เดียวกันซึ่งลงทะเบียนไว้ในเฟรมเวิร์ก Android ผ่านกลไกที่ไม่ระบุซึ่งเจาะจงสำหรับประเภทของการนำส่งที่ใช้

พร็อพเพอร์ตี้: สถานะการรายงาน (`0x0316`)

พร็อพเพอร์ตี้สถานะการรายงาน (0x0316) เป็นพร็อพเพอร์ตี้อ่าน/เขียนที่มี อรรถศาสตร์มาตรฐานตามที่กำหนดไว้ในข้อกำหนด HID โฮสต์ใช้พร็อพเพอร์ตี้นี้เพื่อระบุเหตุการณ์ที่จะรายงานให้อุปกรณ์ทราบ ระบบจะใช้เฉพาะค่า ไม่มีเหตุการณ์ (0x0840) และเหตุการณ์ทั้งหมด (0x0841) เท่านั้น

ค่าเริ่มต้นของช่องนี้ต้องเป็น "ไม่มีเหตุการณ์" และอุปกรณ์ต้องไม่แก้ไขค่านี้ ต้องเป็นโฮสต์เท่านั้น

พร็อพเพอร์ตี้: สถานะพลังงาน (`0x0319`)

พร็อพเพอร์ตี้สถานะพลังงาน (0x0319) เป็นพร็อพเพอร์ตี้อ่าน/เขียนที่มีความหมายตามมาตรฐานตามที่ระบุไว้ในข้อกำหนด HID โฮสต์ใช้ เพื่อบอกอุปกรณ์ว่าต้องอยู่ในรูปแบบใด ระบบจะใช้เฉพาะค่าเปิดเครื่อง (0x0851) และปิดเครื่อง (0x0855) เท่านั้น

อุปกรณ์จะกำหนดค่าเริ่มต้นของช่องนี้และต้องไม่เป็น แก้ไขโดยอุปกรณ์ เฉพาะโฮสต์เท่านั้น

พร็อพเพอร์ตี้: ช่วงเวลาของรายงาน (`0x030E`)

พร็อพเพอร์ตี้ช่วงเวลาการรายงาน (0x030E) เป็นพร็อพเพอร์ตี้อ่าน/เขียนที่มีความหมายตามมาตรฐานตามที่ระบุไว้ในข้อกำหนด HID โฮสต์ใช้พร็อพเพอร์ตี้นี้เพื่อระบุความถี่ในการรายงานค่าที่อ่านได้จากอุปกรณ์ หน่วยเป็นวินาที ช่วงที่ถูกต้องสำหรับค่านี้จะกำหนดโดยอุปกรณ์ และอธิบายโดยใช้กลไก Physical นาที/สูงสุด อย่างน้อย 50 Hz จะต้องมีการรองรับอัตราการรายงาน และอัตราการรายงานสูงสุดที่แนะนำคือ 100 Hz ดังนั้น ช่วงเวลาการรายงานขั้นต่ำจะต้องน้อยกว่าหรือเท่ากับ 20 มิลลิวินาที และขอแนะนำให้มากกว่าหรือเท่ากับ 10 มิลลิวินาที

พร็อพเพอร์ตี้: LE Transport ที่ผู้ให้บริการสงวนไว้ (`0xF410`)

พร็อพเพอร์ตี้ LE Transport (0xF410) ที่ผู้ให้บริการจองไว้เป็นพร็อพเพอร์ตี้แบบอ่าน/เขียนที่มีความหมายตามมาตรฐานตามที่ระบุไว้ในข้อกำหนด HID ผู้จัด ใช้พร็อพเพอร์ตี้นี้เพื่อระบุการขนส่งที่เลือก (ACL หรือ ISO) เฉพาะ ใช้ค่า ACL (0xF800) และ ISO (0xF801) และต้องรวมทั้ง 2 ค่า ในคอลเล็กชันเชิงตรรกะ

พร็อพเพอร์ตี้นี้ได้รับการกำหนดค่าก่อนสถานะกำลังหรือการรายงาน

ช่องข้อมูล: ค่าที่กำหนดเอง 1 (`0x0544`)

ช่องค่าที่กำหนดเอง 1 (0x0544) คือช่องป้อนข้อมูลที่ใช้สำหรับการรายงานข้อมูลการติดตามการเคลื่อนไหวของศีรษะจริง อาร์เรย์ 3 องค์ประกอบที่ตีความตามกฎ HID ปกติสำหรับค่าทางกายภาพตามที่ระบุไว้ในส่วนที่ 6.2.2.7 ของข้อกำหนด HID ช่วงที่ถูกต้องสำหรับแต่ละองค์ประกอบคือ [-π, π] เรเดียน หน่วยจะเป็นเรเดียนเสมอ

ระบบจะตีความองค์ประกอบเป็น [rx, ry, rz] ดังนั้น [rx, ry, rz] เป็น เวกเตอร์การหมุน แสดงการเปลี่ยนรูปแบบจากเฟรมอ้างอิงเป็นเฟรมส่วนหัว ระดับความรุนแรงต้องอยู่ในช่วง [0..π]

เฟรมอ้างอิงเป็นค่าที่กำหนดเอง แต่โดยทั่วไปจะกำหนดไว้แบบคงที่และต้องเป็นแบบมือขวา ยอมรับความคลาดเคลื่อนได้เล็กน้อย แกนส่วนหัว ได้แก่

X จากหูซ้ายไปขวา
Y จากด้านหลังของศีรษะถึงจมูก (กลับไปด้านหน้า)
ตัว Z จากคอไปจนถึงด้านบนของศีรษะ

ฟิลด์ข้อมูล: ค่าที่กำหนดเอง 2 (`0x0545`)

ช่องค่าที่กำหนดเอง 2 (0x0545) คือช่องป้อนข้อมูลที่ใช้สำหรับการรายงานข้อมูลการติดตามการเคลื่อนไหวของศีรษะจริง อาร์เรย์จุดคงที่ 3 องค์ประกอบ ซึ่งตีความตามกฎ HID ปกติสำหรับค่าทางกายภาพ หน่วยจะเป็นเรเดียน/วินาทีเสมอ

ระบบจะตีความองค์ประกอบเป็น [vx, vy, vz] โดยที่ [vx, vy, vz] เป็นเวกเตอร์การหมุน ซึ่งแสดงถึงความเร็วเชิงมุมของเฟรมส่วนหัว (เทียบกับเฟรมส่วนหัวเอง)

ช่องข้อมูล: ค่าที่กำหนดเอง 3 (`0x0546`)

ฟิลด์ค่าที่กำหนดเอง 3 (0x0546) คือช่องป้อนข้อมูลที่ใช้ติดตามการหยุดชะงักในเฟรมอ้างอิง เป็นจำนวนเต็มสเกลาร์ 8 บิตใน ขนาด 100 x 240 อุปกรณ์ต้องเพิ่มค่า (แบบวนรอบ) ทุกครั้งที่มีการเปลี่ยนแปลงเฟรมอ้างอิง เช่น หากอัลกอริทึมตัวกรองการวางแนวที่ใช้สำหรับกำหนดการวางแนวมีการรีเซ็ตสถานะ ค่านี้คือ ได้รับการแปลค่าตามกฎ HID ปกติสำหรับค่าทางกายภาพ อย่างไรก็ตาม คุณค่าทางกายภาพและหน่วยนั้นไม่สำคัญ ข้อมูลเดียวที่เกี่ยวข้องกับโฮสต์คือค่าที่เปลี่ยนแปลง เพื่อหลีกเลี่ยงปัญหาเกี่ยวกับตัวเลขที่เกี่ยวข้องกับการสูญเสียความแม่นยำขณะแปลงจากหน่วยตรรกะเป็นหน่วยจริง ขอแนะนําให้ตั้งค่าค่าของค่าต่ำสุดจริง ค่าสูงสุดจริง และตัวคูณหน่วยเป็น 0 สําหรับช่องนี้

โครงสร้างรายงาน

การจัดกลุ่มพร็อพเพอร์ตี้ลงในรายงาน (ตามการกำหนดรหัสรายงาน) คือ ได้อย่างยืดหยุ่น เราขอแนะนำให้แยกพร็อพเพอร์ตี้ที่อ่านอย่างเดียวออกจากพร็อพเพอร์ตี้ที่อ่าน/เขียนเพื่อให้มีประสิทธิภาพ

สำหรับช่องข้อมูล ค่าที่กำหนดเอง 1, 2 และ 3 ต้องเหมือนกัน และอยู่ในรายงานเพียงฉบับเดียวสำหรับอุปกรณ์หนึ่งๆ (คอลเล็กชันแอป)

ส่งรายงานอินพุต

อุปกรณ์ต้องส่งรายงานอินพุตเป็นระยะๆ และไม่พร้อมกัน (ผ่านข้อความ HID INPUT) เมื่อเป็นไปตามเงื่อนไขทั้งหมดต่อไปนี้

พร็อพเพอร์ตี้สถานะพลังงานได้รับการตั้งค่าเป็น "พลังงานเต็ม"
ตั้งค่าพร็อพเพอร์ตี้สถานะการรายงานเป็นเหตุการณ์ทั้งหมด
พร็อพเพอร์ตี้ช่วงเวลาการรายงานไม่ใช่ 0

พร็อพเพอร์ตี้ช่วงเวลาการรายงานจะเป็นตัวกำหนดความถี่ในการส่งรายงาน วันและเวลา ไม่ตรงตามเงื่อนไขใดๆ ข้างต้น อุปกรณ์ต้องไม่ส่งรายงานใดๆ

ความเข้ากันได้แบบย้อนหลังและไปข้างหน้า

โปรโตคอล HID เครื่องมือติดตามส่วนหัวใช้รูปแบบการกำหนดเวอร์ชันที่อนุญาตให้ โดยอนุญาตให้สามารถทำงานร่วมกันระหว่างโฮสต์และอุปกรณ์ที่ใช้ โปรโตคอลเวอร์ชันต่างๆ เวอร์ชันของโปรโตคอลจะระบุด้วยตัวเลข 2 ตัว ได้แก่ หลักและรอง ซึ่งมีความหมายแตกต่างกันตามที่อธิบายไว้ในส่วนต่อไปนี้

คุณสามารถระบุเวอร์ชันที่อุปกรณ์รองรับได้โดยการตรวจสอบพร็อพเพอร์ตี้คำอธิบายเซ็นเซอร์ (0x0308) ของอุปกรณ์

ความเข้ากันได้กับเวอร์ชันย่อย

การเปลี่ยนแปลงในเวอร์ชันย่อยจะใช้งานร่วมกับเวอร์ชันย่อยก่อนหน้าซึ่งอิงตามเวอร์ชันหลักเดียวกันได้ ข้อมูลอัปเดตเกี่ยวกับผู้เยาว์ โฮสต์จะไม่สนใจฟิลด์ข้อมูลและพร็อพเพอร์ตี้เพิ่มเติม ตัวอย่างเช่น อุปกรณ์ที่ใช้โปรโตคอลเวอร์ชัน 1.6 จะใช้ร่วมกับโฮสต์ที่รองรับโปรโตคอลเวอร์ชัน 1.x ซึ่งรวมถึงเวอร์ชัน 1.5 ได้

ความเข้ากันได้ของเวอร์ชันหลัก

อนุญาตให้ใช้การเปลี่ยนแปลงที่เข้ากันไม่ได้กับการเปลี่ยนแปลงเวอร์ชันหลัก ถึง รองรับเวอร์ชันหลักหลายเวอร์ชันเพื่อ ความสามารถในการทำงานร่วมกับโฮสต์เก่าและใหม่ อุปกรณ์สามารถระบุคอลเล็กชันแอปหลายรายการในรายงานได้ ข้อบ่งชี้ เช่น

const unsigned char ReportDescriptor[] = {
    HID_USAGE_PAGE_SENSOR,
    HID_USAGE_SENSOR_TYPE_OTHER_CUSTOM,

    HID_COLLECTION(HID_APPLICATION),
        // Feature report 2 (read-only).
        HID_REPORT_ID(2),

        // Magic value: "#AndroidHeadTracker#1.5"
        HID_USAGE_SENSOR_PROPERTY_SENSOR_DESCRIPTION,
        HID_LOGICAL_MIN_8(0),
        HID_LOGICAL_MAX_8(0xFF),
        HID_REPORT_SIZE(8),
        HID_REPORT_COUNT(23),
        HID_FEATURE(HID_CONST_VAR_ABS),

      ...

    HID_END_COLLECTION,

    HID_COLLECTION(HID_APPLICATION),
        // Feature report 12 (read-only).
        HID_REPORT_ID(12),

        // Magic value: "#AndroidHeadTracker#2.4"
        HID_USAGE_SENSOR_PROPERTY_SENSOR_DESCRIPTION,
        HID_LOGICAL_MIN_8(0),
        HID_LOGICAL_MAX_8(0xFF),
        HID_REPORT_SIZE(8),
        HID_REPORT_COUNT(23),
        HID_FEATURE(HID_CONST_VAR_ABS),

      ...

    HID_END_COLLECTION,
};

ในกรณีนี้ โฮสต์จะแจกแจงคอลเล็กชันแอปต่างๆ ทั้งหมดที่อุปกรณ์โฆษณา โดยตรวจสอบพร็อพเพอร์ตี้คำอธิบายเซ็นเซอร์เพื่อระบุเวอร์ชันโปรโตคอลที่ใช้ จากนั้นเลือกเวอร์ชันโปรโตคอลล่าสุดที่โฮสต์รองรับ เมื่อเลือกแล้ว โฮสต์จะทำงาน ด้วยโปรโตคอลเดียวที่เลือกไว้สำหรับอายุการใช้งานของอุปกรณ์ การเชื่อมต่อ

ภาคผนวก: ตัวอย่างตัวระบุ HID

ตัวอย่างต่อไปนี้แสดงข้อบ่งชี้ HID ที่ถูกต้องโดยทั่วไป โดยใช้ มาโคร C ที่ใช้กันโดยทั่วไป โดยอยู่ใน การใช้งานเซ็นเซอร์ HID (ส่วนที่ 4.1)

const unsigned char ReportDescriptor[] = {
    HID_USAGE_PAGE_SENSOR,
    HID_USAGE_SENSOR_TYPE_OTHER_CUSTOM,
    HID_COLLECTION(HID_APPLICATION),
        // Feature report 2 (read-only).
        HID_REPORT_ID(2),

        // Magic value: "#AndroidHeadTracker#1.0"
        HID_USAGE_SENSOR_PROPERTY_SENSOR_DESCRIPTION,
        HID_LOGICAL_MIN_8(0),
        HID_LOGICAL_MAX_8(0xFF),
        HID_REPORT_SIZE(8),
        HID_REPORT_COUNT(23),
        HID_FEATURE(HID_CONST_VAR_ABS),

        // UUID.
        HID_USAGE_SENSOR_PROPERTY_PERSISTENT_UNIQUE_ID,
        HID_LOGICAL_MIN_8(0),
        HID_LOGICAL_MAX_8(0xFF),
        HID_REPORT_SIZE(8),
        HID_REPORT_COUNT(16),
        HID_FEATURE(HID_CONST_VAR_ABS),

        // Feature report 1 (read/write).
        HID_REPORT_ID(1),

        // 1-bit on/off reporting state.
        HID_USAGE_SENSOR_PROPERTY_REPORTING_STATE,
        HID_LOGICAL_MIN_8(0),
        HID_LOGICAL_MAX_8(1),
        HID_REPORT_SIZE(1),
        HID_REPORT_COUNT(1),
        HID_COLLECTION(HID_LOGICAL),
            HID_USAGE_SENSOR_PROPERTY_REPORTING_STATE_NO_EVENTS,
            HID_USAGE_SENSOR_PROPERTY_REPORTING_STATE_ALL_EVENTS,
            HID_FEATURE(HID_DATA_ARR_ABS),
        HID_END_COLLECTION,

        // 1-bit on/off power state.
        HID_USAGE_SENSOR_PROPERTY_POWER_STATE,
        HID_LOGICAL_MIN_8(0),
        HID_LOGICAL_MAX_8(1),
        HID_REPORT_SIZE(1),
        HID_REPORT_COUNT(1),
        HID_COLLECTION(HID_LOGICAL),
            HID_USAGE_SENSOR_PROPERTY_POWER_STATE_D4_POWER_OFF,
            HID_USAGE_SENSOR_PROPERTY_POWER_STATE_D0_FULL_POWER,
            HID_FEATURE(HID_DATA_ARR_ABS),
        HID_END_COLLECTION,

        // 6-bit reporting interval, with values [0x00..0x3F] corresponding to [10ms..100ms].
        HID_USAGE_SENSOR_PROPERTY_REPORT_INTERVAL,
        HID_LOGICAL_MIN_8(0x00),
        HID_LOGICAL_MAX_8(0x3F),
        HID_PHYSICAL_MIN_8(10),
        HID_PHYSICAL_MAX_8(100),
        HID_REPORT_SIZE(6),
        HID_REPORT_COUNT(1),
        HID_USAGE_SENSOR_UNITS_SECOND,
        HID_UNIT_EXPONENT(0xD),  // 10^-3
        HID_FEATURE(HID_DATA_VAR_ABS),

        // Input report 1

        // Orientation as rotation vector (scaled to [-pi..pi] rad).
        HID_USAGE_SENSOR_DATA_CUSTOM_VALUE_1,
        HID_LOGICAL_MIN_16(0x01, 0x80), // LOGICAL_MINIMUM (-32767)
        HID_LOGICAL_MAX_16(0xFF, 0x7F), // LOGICAL_MAXIMUM (32767)
        HID_PHYSICAL_MIN_32(0x60, 0x4F, 0x46, 0xED),  // -314159265
        HID_PHYSICAL_MAX_32(0xA1, 0xB0, 0xB9, 0x12),  // 314159265
        HID_UNIT_EXPONENT(0x08),  // 10^-8
        HID_REPORT_SIZE(16),
        HID_REPORT_COUNT(3),
        HID_INPUT(HID_DATA_VAR_ABS),

        // Angular velocity as rotation vector (scaled to [-32..32] rad/sec).
        HID_USAGE_SENSOR_DATA_CUSTOM_VALUE_2,
        HID_LOGICAL_MIN_16(0x01, 0x80), // LOGICAL_MINIMUM (-32767)
        HID_LOGICAL_MAX_16(0xFF, 0x7F), // LOGICAL_MAXIMUM (32767)
        HID_PHYSICAL_MIN_8(0xE0),
        HID_PHYSICAL_MAX_8(0x20),
        HID_UNIT_EXPONENT(0x00),  // 10^0
        HID_REPORT_SIZE(16),
        HID_REPORT_COUNT(3),
        HID_INPUT(HID_DATA_VAR_ABS),

        // Reference frame reset counter.
        HID_USAGE_SENSOR_DATA_CUSTOM_VALUE_3,
        HID_LOGICAL_MIN_16(0x00, 0x00), // LOGICAL_MINIMUM (0)
        HID_LOGICAL_MAX_16(0xFF, 0x00), // LOGICAL_MAXIMUM (255)
        HID_PHYSICAL_MIN_8(0x00),
        HID_PHYSICAL_MAX_8(0x00),
        HID_UNIT_EXPONENT(0x00),  // 10^0
        HID_REPORT_SIZE(8),
        HID_REPORT_COUNT(1),
        HID_INPUT(HID_DATA_VAR_ABS),

    HID_END_COLLECTION,
};

ภาคผนวก 2: ตัวอย่างข้อบ่งชี้ HID v2.0

ตัวอย่างต่อไปนี้แสดงข้อบ่งชี้ HID v2.0 สำหรับอุปกรณ์ที่รองรับ เฉพาะการรับส่ง Bluetooth LE ACL เท่านั้น

const unsigned char ReportDescriptor[] = {
    HID_USAGE_PAGE_SENSOR,
    HID_USAGE_SENSOR_TYPE_OTHER_CUSTOM,
    HID_COLLECTION(HID_APPLICATION),
        // Feature report 2 (read-only).
        HID_REPORT_ID(2),

        // Magic value: "#AndroidHeadTracker#2.0#1"
        HID_USAGE_SENSOR_PROPERTY_SENSOR_DESCRIPTION,
        HID_LOGICAL_MIN_8(0),
        HID_LOGICAL_MAX_8(0xFF),
        HID_REPORT_SIZE(8),
        HID_REPORT_COUNT(25),
        HID_FEATURE(HID_CONST_VAR_ABS),

        // UUID.
        HID_USAGE_SENSOR_PROPERTY_PERSISTENT_UNIQUE_ID,
        HID_LOGICAL_MIN_8(0),
        HID_LOGICAL_MAX_8(0xFF),
        HID_REPORT_SIZE(8),
        HID_REPORT_COUNT(16),
        HID_FEATURE(HID_CONST_VAR_ABS),

        // Feature report 1 (read/write).
        HID_REPORT_ID(1),

        // 1-bit on/off reporting state.
        HID_USAGE_SENSOR_PROPERTY_REPORTING_STATE,
        HID_LOGICAL_MIN_8(0),
        HID_LOGICAL_MAX_8(1),
        HID_REPORT_SIZE(1),
        HID_REPORT_COUNT(1),
        HID_COLLECTION(HID_LOGICAL),
            HID_USAGE_SENSOR_PROPERTY_REPORTING_STATE_NO_EVENTS,
            HID_USAGE_SENSOR_PROPERTY_REPORTING_STATE_ALL_EVENTS,
            HID_FEATURE(HID_DATA_ARR_ABS),
        HID_END_COLLECTION,

        // 1-bit on/off power state.
        HID_USAGE_SENSOR_PROPERTY_POWER_STATE,
        HID_LOGICAL_MIN_8(0),
        HID_LOGICAL_MAX_8(1),
        HID_REPORT_SIZE(1),
        HID_REPORT_COUNT(1),
        HID_COLLECTION(HID_LOGICAL),
            HID_USAGE_SENSOR_PROPERTY_POWER_STATE_D4_POWER_OFF,
            HID_USAGE_SENSOR_PROPERTY_POWER_STATE_D0_FULL_POWER,
            HID_FEATURE(HID_DATA_ARR_ABS),
        HID_END_COLLECTION,

        // 6-bit reporting interval, with values [0x00..0x3F] corresponding to [10ms..100ms].
        HID_USAGE_SENSOR_PROPERTY_REPORT_INTERVAL,
        HID_LOGICAL_MIN_8(0x00),
        HID_LOGICAL_MAX_8(0x3F),
        HID_PHYSICAL_MIN_8(10),
        HID_PHYSICAL_MAX_8(100),
        HID_REPORT_SIZE(6),
        HID_REPORT_COUNT(1),
        HID_USAGE_SENSOR_UNITS_SECOND,
        HID_UNIT_EXPONENT(0xD),  // 10^-3
        HID_FEATURE(HID_DATA_VAR_ABS),

        // 1-bit transport selection
        HID_USAGE_SENSOR_PROPERTY_VENDOR_LE_TRANSPORT,
        HID_LOGICAL_MIN_8(0),
        HID_LOGICAL_MAX_8(1),
        HID_REPORT_SIZE(1),
        HID_REPORT_COUNT(1),
        HID_COLLECTION(HID_LOGICAL),
            HID_USAGE_SENSOR_PROPERTY_VENDOR_LE_TRANSPORT_ACL,
            HID_USAGE_SENSOR_PROPERTY_VENDOR_LE_TRANSPORT_ISO,
            HID_FEATURE(HID_DATA_ARR_ABS),
        HID_END_COLLECTION,

        // Input report 1

        // Orientation as rotation vector (scaled to [-pi..pi] rad).
        HID_USAGE_SENSOR_DATA_CUSTOM_VALUE_1,
        HID_LOGICAL_MIN_16(0x01, 0x80), // LOGICAL_MINIMUM (-32767)
        HID_LOGICAL_MAX_16(0xFF, 0x7F), // LOGICAL_MAXIMUM (32767)
        HID_PHYSICAL_MIN_32(0x60, 0x4F, 0x46, 0xED),  // -314159265
        HID_PHYSICAL_MAX_32(0xA1, 0xB0, 0xB9, 0x12),  // 314159265
        HID_UNIT_EXPONENT(0x08),  // 10^-8
        HID_REPORT_SIZE(16),
        HID_REPORT_COUNT(3),
        HID_INPUT(HID_DATA_VAR_ABS),

        // Angular velocity as rotation vector (scaled to [-32..32] rad/sec).
        HID_USAGE_SENSOR_DATA_CUSTOM_VALUE_2,
        HID_LOGICAL_MIN_16(0x01, 0x80), // LOGICAL_MINIMUM (-32767)
        HID_LOGICAL_MAX_16(0xFF, 0x7F), // LOGICAL_MAXIMUM (32767)
        HID_PHYSICAL_MIN_8(0xE0),
        HID_PHYSICAL_MAX_8(0x20),
        HID_UNIT_EXPONENT(0x00),  // 10^0
        HID_REPORT_SIZE(16),
        HID_REPORT_COUNT(3),
        HID_INPUT(HID_DATA_VAR_ABS),

        // Reference frame reset counter.
        HID_USAGE_SENSOR_DATA_CUSTOM_VALUE_3,
        HID_LOGICAL_MIN_16(0x00, 0x00), // LOGICAL_MINIMUM (0)
        HID_LOGICAL_MAX_16(0xFF, 0x00), // LOGICAL_MAXIMUM (255)
        HID_PHYSICAL_MIN_8(0x00),
        HID_PHYSICAL_MAX_8(0x00),
        HID_UNIT_EXPONENT(0x00),  // 10^0
        HID_REPORT_SIZE(8),
        HID_REPORT_COUNT(1),
        HID_INPUT(HID_DATA_VAR_ABS),

    HID_END_COLLECTION,
};