החל מ-27 במרץ 2025, מומלץ להשתמש ב-android-latest-release במקום ב-aosp-main כדי ליצור תרומות ל-AOSP. מידע נוסף זמין במאמר שינויים ב-AOSP.
אוזניות USB: מפרט המכשיר
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
כדי שדיבוריות USB יפעלו בצורה חלקה בסביבת Android, מכשירי Android חייבים לתמוך בהן באופן אחיד. במסמך הזה מפורט התנהגות ה-USB כדי לתמוך באוזניות ובמתאמים של USB בסביבת Android.
מיפוי תוכנות
אוזניות USB תואמות נדרשות כדי לתמוך במיפויים תואמים של HID.
נדרשת תמיכה במכשיר למיפויי מפתחות הקוד הבאים.
| פעולה |
מיפויים |
הקשר |
התנהגות |
| A |
דף השימוש ב-HID: 0x0C
שימוש ב-HID: 0x0CD
מפתח הליבה: 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
מפתח הליבה: KEY_VOLUMEUP
מפתח Android: VOLUME_UP |
הפעלת מדיה, שיחה פעילה |
קלט: לחיצה קצרה או לחיצה ארוכה
פלט: הגברת עוצמת הקול של המערכת או של אוזניות |
| C |
דף השימוש ב-HID: 0x0C
שימוש ב-HID: 0x0EA
מפתח הליבה: KEY_VOLUMEDOWN
מפתח Android: VOLUME_DOWN |
הפעלת מדיה, שיחה פעילה |
קלט: לחיצה קצרה או לחיצה ארוכה
פלט: הפחתת עוצמת הקול במערכת או באוזניות |
| D |
דף השימוש ב-HID: 0x0C
שימוש ב-HID: 0x0CF
מפתח הליבה: KEY_VOICECOMMAND
מפתח Android: KEYCODE_VOICE_ASSIST |
כל ההתראות. אפשר להפעיל אותו בכל מכונה. |
קלט: לחיצה קצרה או לחיצה ארוכה
פלט: הפעלת פקודת קול |
חומרה
יצרני מכשירים צריכים לעיין גם במאמר אודיו דיגיטלי ב-USB כדי לקבל מידע נוסף על הטמעת USB ב-Android. יצרני המכשירים חייבים גם לעמוד בדרישות המפורטות בקטע USB ב-CDD של Android.
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-27 (שעון 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-27 (שעון 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."]]
