Начиная с 27 марта 2025 г. мы рекомендуем использовать android-latest-release
вместо aosp-main
для создания и участия в AOSP. Дополнительные сведения см. в разделе Изменения в AOSP .
USB-гарнитура: Спецификация устройства
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Чтобы USB-гарнитуры беспрепятственно работали в экосистеме Android, устройства Android должны поддерживать их единообразно. В этой документации указано поведение USB для поддержки USB-гарнитур и адаптеров в экосистеме Android.
Сопоставление программного обеспечения
Для поддержки совместимых сопоставлений HID необходимы совместимые USB-гарнитуры. Поддержка устройства требуется для следующих сопоставлений кодов клавиш.
Функция | Сопоставления | Контекст | Поведение |
---|
А | Страница использования HID : 0x0C Использование HID : 0x0CD Ключ ядра : KEY_PLAYPAUSE Ключ Android : KEYCODE_MEDIA_PLAY_PAUSE | Воспроизведение мультимедиа | Ввод : Короткое нажатие. Выход : Воспроизведение или пауза. |
Ввод : Длительное нажатие Вывод : Запустить голосовую команду. Отправляет : android.speech.action.VOICE_SEARCH_HANDS_FREE , если устройство заблокировано или его экран выключен. В противном случае отправляет android.speech.RecognizerIntent.ACTION_WEB_SEARCH |
Входящий звонок | Ввод : Короткое нажатие. Вывод : принять вызов |
Ввод : Длительное нажатие Вывод : Отклонить вызов |
Текущий звонок | Ввод : Короткое нажатие. Выход : Завершить вызов. |
Ввод : Длительное нажатие Выход : отключить или включить микрофон. |
Б | Страница использования HID : 0x0C Использование HID : 0x0E9 Ключ ядра : KEY_VOLUMEUP Ключ Android : VOLUME_UP | Воспроизведение мультимедиа, текущий вызов | Ввод : короткое или длинное нажатие. Выход : увеличивает громкость системы или гарнитуры. |
С | Страница использования HID : 0x0C Использование HID : 0x0EA Ключ ядра : KEY_VOLUMEDOWN Ключ Android : VOLUME_DOWN | Воспроизведение мультимедиа, текущий вызов | Ввод : короткое или длинное нажатие. Выход : Уменьшает громкость системы или гарнитуры. |
Д | Страница использования HID : 0x0C Использование HID : 0x0CF Ключ ядра : KEY_VOICECOMMAND Ключ Android : KEYCODE_VOICE_ASSIST . | Все. Может быть запущен в любом случае. | Ввод : короткое или длинное нажатие. Вывод : Запустить голосовую команду. |
Аппаратное обеспечение
Производителям устройств также следует ознакомиться с цифровым звуком USB для получения дополнительной информации о реализации USB на Android. Производители устройств также должны соблюдать требования раздела USB на компакт-диске Android.
Контент и образцы кода на этой странице предоставлены по лицензиям. Java и OpenJDK – это зарегистрированные товарные знаки корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-29 UTC.
[[["Прост для понимания","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-29 UTC."],[],[],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."]]