اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.
سماعة رأس USB: مواصفات الجهاز
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
لكي تعمل سماعات الرأس USB بسلاسة في منظومة Android المتكاملة، يجب أن تكون متوافقة بشكل موحّد مع أجهزة Android. تحدِّد هذه المستندات سلوك USB
لتفعيل سماعات الرأس والمحولات USB في منظومة Android المتكاملة.
ربط البرامج
يجب استخدام سماعات رأس متوافقة مع USB لتفعيل عمليات الربط المتوافقة مع HID.
يجب أن يكون الجهاز متوافقًا مع عمليات ربط رموز المفاتيح التالية.
| الوظيفة |
عمليات الربط |
السياق |
السُلوك |
| A |
صفحة استخدام HID: 0x0C
استخدام HID: 0x0CD
مفتاح kernel: KEY_PLAYPAUSE
مفتاح Android: KEYCODE_MEDIA_PLAY_PAUSE |
تشغيل الوسائط |
الإدخال: الضغط لفترة قصيرة
النتيجة: التشغيل أو الإيقاف المؤقت |
الإدخال: الضغط مع الاستمرار
الإخراج: تفعيل الأمر الصوتي
الإرسال:
android.speech.action.VOICE_SEARCH_HANDS_FREE إذا كان الجهاز
مقفلاً أو كانت شاشته مطفأة، يتم إرسالandroid.speech.RecognizerIntent.ACTION_WEB_SEARCH في الحالات الأخرى |
| مكالمة واردة |
الإدخال: الضغط لفترة قصيرة
النتيجة: قبول المكالمة |
الإدخال: الضغط مع الاستمرار
النتيجة: رفض المكالمة |
| مكالمة جارية |
الإدخال: الضغط لفترة قصيرة
النتيجة: إنهاء المكالمة |
الإدخال: الضغط مع الاستمرار
الإخراج: كتم صوت الميكروفون أو إعادة صوته |
| B |
صفحة استخدام HID: 0x0C
استخدام HID: 0x0E9
مفتاح kernel: KEY_VOLUMEUP
مفتاح Android: VOLUME_UP |
تشغيل الوسائط، مكالمة جارية |
الإدخال: الضغط لفترة قصيرة أو طويلة
النتيجة: رفع مستوى صوت النظام أو سماعة الرأس |
| C |
صفحة استخدام HID: 0x0C
استخدام HID: 0x0EA
مفتاح kernel: KEY_VOLUMEDOWN
مفتاح Android: VOLUME_DOWN |
تشغيل الوسائط، مكالمة جارية |
الإدخال: الضغط لفترة قصيرة أو طويلة
الإخراج: خفض مستوى صوت النظام أو سماعة الرأس |
| D |
صفحة استخدام HID: 0x0C
استخدام HID: 0x0CF
مفتاح kernel: KEY_VOICECOMMAND
مفتاح Android: KEYCODE_VOICE_ASSIST |
الكل. يمكن تشغيله في أيّ مثيل. |
الإدخال: الضغط لفترة قصيرة أو طويلة
النتيجة: تفعيل الطلب الصوتي |
الأجهزة
على الشركات المصنّعة للأجهزة أيضًا الاطّلاع على الصوت الرقمي عبر USB للحصول على مزيد من المعلومات حول استخدام USB على Android. على المصنّعين أيضًا
اتّباع المتطلبات الواردة في
قسم USB من "ملحقات توافق الأجهزة مع Android".
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# USB headset: Device specification\n\nFor USB headsets to work seamlessly across the Android ecosystem, Android\ndevices must support them uniformly. This documentation specifies USB\nbehavior to support USB headsets and adapters across the Android ecosystem.\n\nSoftware mapping\n----------------\n\n\nCompatible USB headsets are required to support compatible HID mappings.\nDevice support is required for the following keycode mappings.\n\n| Function | Mappings | Context | Behavior |\n|----------|-------------------------------------------------------------------------------------------------------------------------------|----------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| A | **HID usage page** : 0x0C **HID usage** : 0x0CD **Kernel key** : `KEY_PLAYPAUSE` **Android key** : `KEYCODE_MEDIA_PLAY_PAUSE` | Media playback | **Input** : Short press **Output**: Play or pause |\n| A | **HID usage page** : 0x0C **HID usage** : 0x0CD **Kernel key** : `KEY_PLAYPAUSE` **Android key** : `KEYCODE_MEDIA_PLAY_PAUSE` | Media playback | **Input** : Long press **Output** : Launch voice command **Sends** : `android.speech.action.VOICE_SEARCH_HANDS_FREE` if the device is locked or its screen is off. Sends `android.speech.RecognizerIntent.ACTION_WEB_SEARCH` otherwise |\n| A | **HID usage page** : 0x0C **HID usage** : 0x0CD **Kernel key** : `KEY_PLAYPAUSE` **Android key** : `KEYCODE_MEDIA_PLAY_PAUSE` | Incoming call | **Input** : Short press **Output**: Accept call |\n| A | **HID usage page** : 0x0C **HID usage** : 0x0CD **Kernel key** : `KEY_PLAYPAUSE` **Android key** : `KEYCODE_MEDIA_PLAY_PAUSE` | Incoming call | **Input** : Long press **Output**: Reject call |\n| A | **HID usage page** : 0x0C **HID usage** : 0x0CD **Kernel key** : `KEY_PLAYPAUSE` **Android key** : `KEYCODE_MEDIA_PLAY_PAUSE` | Ongoing call | **Input** : Short press **Output**: End call |\n| A | **HID usage page** : 0x0C **HID usage** : 0x0CD **Kernel key** : `KEY_PLAYPAUSE` **Android key** : `KEYCODE_MEDIA_PLAY_PAUSE` | Ongoing call | **Input** : Long press **Output**: Mute or unmute microphone |\n| B | **HID usage page** : 0x0C **HID usage** : 0x0E9 **Kernel key** : `KEY_VOLUMEUP` **Android key** : `VOLUME_UP` | Media playback, Ongoing call | **Input** : Short or long press **Output**: Increases the system or headset volume |\n| C | **HID usage page** : 0x0C **HID usage** : 0x0EA **Kernel key** : `KEY_VOLUMEDOWN` **Android key** : `VOLUME_DOWN` | Media playback, Ongoing call | **Input** : Short or long press **Output**: Decreases the system or headset volume |\n| D | **HID usage page** : 0x0C **HID usage** : 0x0CF **Kernel key** : `KEY_VOICECOMMAND` **Android key** : `KEYCODE_VOICE_ASSIST` | All. Can be triggered in any instance. | **Input** : Short or long press **Output**: Launch voice command |\n\nHardware\n--------\n\n\nDevice manufacturers should also see\n[USB digital audio](/docs/core/audio/usb) for more\ninformation about USB implementation on Android. Device manufacturers must also\nfollow the requirements in the\n[USB section](/docs/compatibility/13/android-13-cdd#77_usb) of the Android CDD."]]
