chrome.audio

refresh date: 2026-09-25 robots: noindex

الوصف

يتم توفير واجهة برمجة التطبيقات chrome.audio للسماح للمستخدمين بالحصول على معلومات حول أجهزة الصوت المتصلة بالنظام والتحكّم فيها. لا تتوفّر واجهة برمجة التطبيقات هذه حاليًا إلا في "وضع Kiosk" على ChromeOS.

الأذونات

audio

مدى التوفّر

الإصدار 59 من Chrome أو الإصدارات الأحدث نظام التشغيل ChromeOS فقط

الأنواع

AudioDeviceInfo

الخصائص

  • deviceName

    سلسلة

    اسم الجهاز

  • deviceType

    DeviceType

    نوع الجهاز

  • displayName

    سلسلة

    الاسم السهل الاستخدام (مثل "ميكروفون USB").

  • id

    سلسلة

    المعرّف الفريد لجهاز الصوت

  • isActive

    قيمة منطقية

    تكون القيمة "صحيح" إذا كان هذا هو الجهاز النشط حاليًا.

  • مستوى

    الرقم

    مستوى صوت الجهاز، ومستوى صوت الإخراج، ومستوى صوت الإدخال

  • stableDeviceId

    سلسلة اختيارية

    سلسلة رقم تعريف الجهاز الثابت/المستمر عند توفّره

  • streamType

    StreamType

    نوع البث المرتبط بهذا الجهاز

DeviceFilter

الخصائص

  • isActive

    boolean اختياري

    في حال ضبط هذه السمة، لن يستوفي الفلتر إلا أجهزة الصوت التي تتطابق حالتها النشطة مع هذه القيمة.

  • streamTypes

    StreamType[] اختياري

    في حال ضبط هذا الإعداد، لن تستوفي الفلتر سوى أجهزة الصوت التي يتضمّن هذا الإعداد نوع بثها.

DeviceIdLists

الخصائص

  • إدخال

    string[] اختياري

    قائمة بأجهزة الإدخال المحدّدة حسب معرّفاتها

    للتأكيد على عدم تأثُّر أجهزة الإدخال، اترُك هذه السمة بدون ضبط.

  • output

    string[] اختياري

    قائمة بأجهزة الإخراج المحدّدة حسب رقم التعريف

    للتأكيد على أنّه يجب ألا تتأثر أجهزة الإخراج، اترك هذه السمة بدون ضبط.

DeviceProperties

الخصائص

  • مستوى

    number اختياري

    مستوى الصوت المطلوب لجهاز الصوت يكون هذا الإعداد تلقائيًا على مستوى الصوت الحالي للجهاز.

    إذا تم استخدامه مع جهاز إدخال الصوت، يمثّل مستوى الصوت الملتقط.

    في حال استخدامها مع جهاز إخراج الصوت، تمثّل مستوى صوت الجهاز الصوتي.

DeviceType

أنواع أجهزة الصوت المتاحة

تعداد

"HEADPHONE"

"MIC"

"USB"

"BLUETOOTH"

"HDMI"

"INTERNAL_SPEAKER"

"INTERNAL_MIC"

"FRONT_MIC"

"REAR_MIC"

"KEYBOARD_MIC"

"الكلمة المحفّزة"

"LINEOUT"

"POST_MIX_LOOPBACK"

"POST_DSP_LOOPBACK"

"ALSA_LOOPBACK"

"OTHER"

LevelChangedEvent

الخصائص

  • deviceId

    سلسلة

    معرّف الجهاز الذي تم تغيير مستوى صوته

  • مستوى

    الرقم

    مستوى الصوت الجديد للجهاز

MuteChangedEvent

الخصائص

  • isMuted

    قيمة منطقية

    تحدّد هذه السمة ما إذا كان البث مكتومًا الآن.

  • streamType

    StreamType

    نوع مصدر البيانات الذي تم تغيير قيمة كتم الصوت فيه تنطبق قيمة كتم الصوت المعدَّلة على جميع الأجهزة التي تستخدم نوع البث هذا.

StreamType

نوع البث الذي يوفّره جهاز صوتي

تعداد

"INPUT"

"OUTPUT"

الطُرق

getDevices()

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

تعرض هذه السمة قائمة بأجهزة الصوت التي تم فلترتها استنادًا إلى filter.

المعلمات

  • تصفية

    ‫DeviceFilter اختياري

    خصائص الجهاز التي سيتم فلترة قائمة أجهزة الصوت المعروضة حسبها إذا لم يتم ضبط الفلتر أو تم ضبطه على {}، ستتضمّن قائمة الأجهزة التي يتم عرضها جميع أجهزة الصوت المتاحة.

  • callback

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    (devices: AudioDeviceInfo[]) => void

المرتجعات

  • Promise<AudioDeviceInfo[]>

    الإصدار 116 من Chrome والإصدارات الأحدث

    تعرض هذه السمة قائمة أجهزة الصوت المطلوبة.

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، بينما تحتاج المنصات الأخرى إلى استخدام عمليات معاودة الاتصال.

getMute()

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

تعرض هذه الطريقة حالة الكتم على مستوى النظام لنوع البث المحدّد.

المعلمات

  • streamType

    StreamType

    نوع البث الذي يجب استرداد حالة كتم الصوت له.

  • callback

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    (value: boolean) => void

    • القيمة

      قيمة منطقية

المرتجعات

  • Promise<boolean>

    الإصدار 116 من Chrome والإصدارات الأحدث

    وعد يتم تنفيذه بقيمة منطقية تشير إلى ما إذا كان قد تم ضبط كتم الصوت لنوع البث المحدّد أم لا.

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، بينما تحتاج المنصات الأخرى إلى استخدام عمليات معاودة الاتصال.

setActiveDevices()

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

تضبط هذه السمة قوائم بأجهزة الإدخال و/أو الإخراج النشطة.

المعلمات

  • تحدِّد هذه السمة أرقام تعريف الأجهزة التي يجب أن تكون نشطة. إذا لم يتم ضبط قائمة الإدخال أو الإخراج، لن تتأثر الأجهزة في هذه الفئة.

    يُعدّ إدخال رقم تعريف جهاز غير متوفّر خطأً.

  • callback

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • Promise<void>

    الإصدار 116 من Chrome والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، بينما تحتاج المنصات الأخرى إلى استخدام عمليات معاودة الاتصال.

setMute()

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

تضبط هذه السمة حالة كتم الصوت لنوع بث. سيتم تطبيق حالة كتم الصوت على جميع أجهزة الصوت التي تتضمّن نوع بث الصوت المحدّد.

المعلمات

  • streamType

    StreamType

    نوع البث الذي يجب ضبط حالة كتم الصوت له

  • isMuted

    قيمة منطقية

    قيمة الكتم الجديدة

  • callback

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • Promise<void>

    الإصدار 116 من Chrome والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، بينما تحتاج المنصات الأخرى إلى استخدام عمليات معاودة الاتصال.

setProperties()

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

يضبط خصائص جهاز الإدخال أو الإخراج.

المعلمات

  • id

    سلسلة

  • أماكن الإقامة

    DeviceProperties

  • callback

    الدالة اختيارية

    تظهر المَعلمة callback على النحو التالي: 

    () => void

المرتجعات

  • Promise<void>

    الإصدار 116 من Chrome والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، بينما تحتاج المنصات الأخرى إلى استخدام عمليات معاودة الاتصال.

الفعاليات

onDeviceListChanged

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

يتم تنشيط هذا الحدث عند تغيير أجهزة الصوت، سواء بإضافة أجهزة جديدة أو إزالة أجهزة حالية.

المعلمات

  • callback

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (devices: AudioDeviceInfo[]) => void

onLevelChanged

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

يتم تنشيط هذا الحدث عند تغيُّر مستوى الصوت في جهاز صوتي نشط.

المعلمات

onMuteChanged

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

يتم تنشيط هذا الحدث عند تغيُّر حالة كتم صوت الإدخال أو الإخراج. يُرجى العِلم أنّ حالة كتم الصوت تكون على مستوى النظام، وأنّ القيمة الجديدة تنطبق على كل جهاز صوتي بنوع بث محدّد.

المعلمات