chrome.audio

תאריך הרענון: 2026-09-25 robots: noindex

תיאור

ממשק chrome.audio API מסופק כדי לאפשר למשתמשים לקבל מידע על מכשירי האודיו שמחוברים למערכת ולשלוט בהם. ה-API הזה זמין כרגע רק במצב קיוסק ב-ChromeOS.

הרשאות

audio

זמינות

‫Chrome 59 ואילך ChromeOS בלבד

סוגים

AudioDeviceInfo

מאפיינים

  • deviceName

    מחרוזת

    שם המכשיר.

  • deviceType

    DeviceType

    סוג המכשיר.

  • displayName

    מחרוזת

    השם הידידותי למשתמש (למשל, 'מיקרופון USB').

  • id [מזהה]

    מחרוזת

    המזהה הייחודי של מכשיר האודיו.

  • isActive

    בוליאני

    הערך הוא True אם זה המכשיר הפעיל הנוכחי.

  • שלב

    number

    רמת הקול של המכשיר, עוצמת הקול של הפלט, עוצמת הקול של הקלט.

  • stableDeviceId

    מחרוזת אופציונלי

    מחרוזת מזהה המכשיר היציבה או הקבועה, אם היא זמינה.

  • streamType

    StreamType

    סוג הסטרימינג שמשויך למכשיר הזה.

DeviceFilter

מאפיינים

  • isActive

    ‫boolean אופציונלי

    אם הערך מוגדר, רק מכשירי אודיו שהמצב הפעיל שלהם תואם לערך הזה יעברו את הסינון.

  • streamTypes

    ‫StreamType[] אופציונלי

    אם המדיניות מוגדרת, רק מכשירי אודיו שסוג הזרם שלהם כלול ברשימה הזו יעמדו בדרישות המסנן.

DeviceIdLists

מאפיינים

  • קלט

    string[] אופציונלי

    רשימה של מכשירי קלט שצוינו לפי המזהה שלהם.

    כדי לציין שלא אמורה להיות השפעה על מכשירי קלט, לא מגדירים את המאפיין הזה.

  • output

    string[] אופציונלי

    רשימה של מכשירי פלט שצוינו לפי המזהה שלהם.

    כדי לציין שלא אמורות להיות השפעות על מכשירי פלט, לא מגדירים את המאפיין הזה.

DeviceProperties

מאפיינים

  • שלב

    מספר אופציונלי

    עוצמת הקול הרצויה של מכשיר השמע. ברירת המחדל היא רמת הקול הנוכחית של המכשיר.

    אם משתמשים בו עם מכשיר לקלט אודיו, הוא מייצג את עוצמת הקול של מכשיר האודיו.

    אם משתמשים בו עם מכשיר לפלט אודיו, הוא מייצג את עוצמת הקול של מכשיר האודיו.

DeviceType

סוגי מכשירי האודיו הזמינים.

ספירה

‎"HEADPHONE"

"MIC"

‫"USB"

‪"BLUETOOTH"

‫"HDMI"

‫"INTERNAL_SPEAKER"

‪"INTERNAL_MIC"

"FRONT_MIC"

‫"REAR_MIC"

‫"KEYBOARD_MIC"

‫"HOTWORD"

‫"LINEOUT"

‫"POST_MIX_LOOPBACK"

‫"POST_DSP_LOOPBACK"

‫ALSA_LOOPBACK

‫"OTHER"

LevelChangedEvent

מאפיינים

  • deviceId

    מחרוזת

    המזהה של המכשיר שעוצמת הקול שלו השתנתה.

  • שלב

    number

    רמת השמע החדשה של המכשיר.

MuteChangedEvent

מאפיינים

  • isMuted

    בוליאני

    האם השידור מושתק כרגע.

  • streamType

    StreamType

    סוג הסטרימינג שעבורו השתנה ערך ההשתקה. ערך ההשתקה המעודכן חל על כל המכשירים עם סוג הסטרימינג הזה.

StreamType

סוג הזרם שמספק התקן אודיו.

ספירה

‫"INPUT"

‫"OUTPUT"

Methods

getDevices()

Promise 
chrome.audio.getDevices(
  filter?: DeviceFilter,
  callback?: function,
): Promise<AudioDeviceInfo[]>

מקבל רשימה של מכשירי אודיו שסוננו על סמך filter.

פרמטרים

  • סינון

    ‫DeviceFilter אופציונלי

    מאפייני המכשיר שלפיהם מסננים את רשימת מכשירי האודיו שמוחזרים. אם המסנן לא מוגדר או מוגדר לערך {}, רשימת המכשירים שמוחזרת תכיל את כל מכשירי האודיו הזמינים.

  • callback

    פונקציה אופציונלית

    הפרמטר callback נראה כך: 

    (devices: AudioDeviceInfo[]) => void

החזרות

  • Promise<AudioDeviceInfo[]>

    ‫Chrome 116 ואילך

    הפונקציה מחזירה את רשימת מכשירי האודיו המבוקשת.

    התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.

getMute()

Promise 
chrome.audio.getMute(
  streamType: StreamType,
  callback?: function,
): Promise<boolean>

מחזירה את מצב ההשתקה של המערכת עבור סוג הסטרימינג שצוין.

פרמטרים

  • streamType

    StreamType

    סוג הסטרימינג שעבורו צריך לאחזר את מצב ההשתקה.

  • callback

    פונקציה אופציונלית

    הפרמטר callback נראה כך: 

    (value: boolean) => void

    • ערך

      בוליאני

החזרות

  • Promise<boolean>

    ‫Chrome 116 ואילך

    אובייקט Promise שמוחזר עם ערך בוליאני שמציין אם ההשתקה מוגדרת או לא עבור סוג הסטרימינג שצוין.

    התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.

setActiveDevices()

Promise 
chrome.audio.setActiveDevices(
  ids: DeviceIdLists,
  callback?: function,
): Promise<void>

הגדרת רשימות של מכשירי קלט או פלט פעילים.

פרמטרים

  • מזהים

    DeviceIdLists

    מציינת את מזהי המכשירים שצריכים להיות פעילים. אם רשימת הקלט או רשימת הפלט לא מוגדרות, המדיניות לא משפיעה על מכשירים בקטגוריה הזו.

    העברת מזהה מכשיר שלא קיים היא שגיאה.

  • callback

    פונקציה אופציונלית

    הפרמטר callback נראה כך: 

    () => void

החזרות

  • Promise<void>

    ‫Chrome 116 ואילך

    התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.

setMute()

Promise 
chrome.audio.setMute(
  streamType: StreamType,
  isMuted: boolean,
  callback?: function,
): Promise<void>

הגדרת מצב השתקה לסוג סטרימינג. ההשתקה תחול על כל מכשירי האודיו עם סוג זרם האודיו שצוין.

פרמטרים

  • streamType

    StreamType

    סוג השידור שצריך להגדיר עבורו את מצב ההשתקה.

  • isMuted

    בוליאני

    הערך החדש של ההשתקה.

  • callback

    פונקציה אופציונלית

    הפרמטר callback נראה כך: 

    () => void

החזרות

  • Promise<void>

    ‫Chrome 116 ואילך

    התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.

setProperties()

Promise 
chrome.audio.setProperties(
  id: string,
  properties: DeviceProperties,
  callback?: function,
): Promise<void>

הגדרת המאפיינים של מכשיר הקלט או הפלט.

פרמטרים

  • id [מזהה]

    מחרוזת

  • נכסים

    DeviceProperties

  • callback

    פונקציה אופציונלית

    הפרמטר callback נראה כך: 

    () => void

החזרות

  • Promise<void>

    ‫Chrome 116 ואילך

    התמיכה ב-Promises קיימת רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.

אירועים

onDeviceListChanged

chrome.audio.onDeviceListChanged.addListener(
  callback: function,
)

האירוע מופעל כשמכשירים לאודיו משתנים, כלומר כשמכשירים חדשים מתווספים או כשמכשירים קיימים מוסרים.

פרמטרים

onLevelChanged

chrome.audio.onLevelChanged.addListener(
  callback: function,
)

מופעל כשמשתנה רמת הקול במכשיר אודיו פעיל.

פרמטרים

onMuteChanged

chrome.audio.onMuteChanged.addListener(
  callback: function,
)

מופעלת כשמצב ההשתקה של קלט או פלט האודיו משתנה. שימו לב שהמצב של השתקת המיקרופון הוא מערכתי, והערך החדש חל על כל מכשיר אודיו עם סוג הזרם שצוין.

פרמטרים