chrome.audio
API ارائه شده است تا به کاربران اجازه دهد اطلاعاتی درباره دستگاههای صوتی متصل به سیستم دریافت کرده و آنها را کنترل کنند. این API در حال حاضر فقط در حالت کیوسک برای ChromeOS در دسترس است.
audio
- نام دستگاه
رشته
نام دستگاه.
- نوع وسیله
نوع دستگاه.
- نمایش نام
رشته
نام کاربر پسند (به عنوان مثال "USB Microphone").
- شناسه
رشته
شناسه منحصر به فرد دستگاه صوتی.
- فعال است
بولی
درست است اگر این دستگاه فعال فعلی باشد.
- مرحله
عدد
سطح صدای دستگاه، حجم برای خروجی، بهره برای ورودی.
- stableDeviceId
رشته اختیاری
رشته شناسه دستگاه پایدار/پایدار در صورت موجود بودن.
- نوع جریان
نوع جریان مرتبط با این دستگاه.
- فعال است
بولی اختیاری
اگر تنظیم شود، فقط دستگاههای صوتی که وضعیت فعال آنها با این مقدار مطابقت دارد، فیلتر را برآورده میکند.
- انواع جریان
StreamType [] اختیاری است
در صورت تنظیم، فقط دستگاههای صوتی که نوع پخش آنها در این لیست گنجانده شده است، فیلتر را برآورده میکنند.
- ورودی
رشته[] اختیاری است
لیست دستگاه های ورودی که توسط شناسه آنها مشخص شده است.
برای نشان دادن اینکه دستگاه های ورودی باید بدون تأثیر باشند، این ویژگی را تنظیم نشده رها کنید.
- خروجی
رشته[] اختیاری است
لیست دستگاه های خروجی که توسط شناسه آنها مشخص شده است.
برای نشان دادن اینکه دستگاههای خروجی باید بدون تأثیر باشند، این ویژگی را تنظیم نشده رها کنید.
- مرحله
شماره اختیاری
سطح صدای مورد نظر دستگاه صوتی. به طور پیش فرض سطح صدای فعلی دستگاه را تنظیم می کند.
اگر با دستگاه ورودی صدا استفاده شود، نشان دهنده سود دستگاه صوتی است.
اگر با دستگاه خروجی صدا استفاده شود، نشان دهنده حجم دستگاه صوتی است.
انواع دستگاه های صوتی موجود
"هدفون" "MIC" "یو اس بی" "بلوتوث" "HDMI" "INTERNAL_SPEAKER" "INTERNAL_MIC" "میکروفون جلو" "REAR_MIC" "KEYBOARD_MIC" "HOTWORD" "خط خط" "POST_MIX_LOOPBACK" "POST_DSP_LOOPBACK" "ALSA_LOOPBACK" "دیگر"
- شناسه دستگاه
رشته
شناسه دستگاهی که سطح صدای آن تغییر کرده است.
- مرحله
عدد
سطح صدای جدید دستگاه
- خاموش است
بولی
این که آیا جریان اکنون بیصدا است یا خیر.
- نوع جریان
نوع جریانی که مقدار بی صدا برای آن تغییر کرده است. مقدار بیصدا بهروزرسانی شده برای همه دستگاههای دارای این نوع جریان اعمال میشود.
نوع جریانی که یک دستگاه صوتی ارائه می کند.
"ورودی" "خروجی"
chrome.audio.getDevices(
filter?: DeviceFilter,
callback?: function,
)
لیستی از دستگاه های صوتی فیلتر شده بر اساس filter
دریافت می کند.
- فیلتر کنید
DeviceFilter اختیاری است
ویژگی های دستگاه که با آن لیست دستگاه های صوتی برگشتی را فیلتر می کند. اگر فیلتر تنظیم نشده باشد یا روی
{}
تنظیم نشده باشد، لیست دستگاه های برگشتی شامل همه دستگاه های صوتی موجود خواهد بود. - پاسخ به تماس
عملکرد اختیاری
پارامتر
callback
به نظر می رسد:(devices: AudioDeviceInfo[]) => void
- دستگاه ها
Promise< AudioDeviceInfo []>
Chrome 116+Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به callback ارسال می شود حل می شود.
chrome.audio.getMute(
streamType: StreamType,
callback?: function,
)
حالت بی صدا در سراسر سیستم را برای نوع جریان مشخص شده دریافت می کند.
- نوع جریان
نوع جریانی که برای آن حالت بی صدا باید واکشی شود.
- پاسخ به تماس
عملکرد اختیاری
پارامتر
callback
به نظر می رسد:(value: boolean) => void
- ارزش
بولی
وعده<boolean>
Chrome 116+Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به callback ارسال می شود حل می شود.
chrome.audio.setActiveDevices(
ids: DeviceIdLists,
callback?: function,
)
لیستی از دستگاه های ورودی و/یا خروجی فعال را تنظیم می کند.
- شناسه
شناسه دستگاه هایی را که باید فعال باشند را مشخص می کند. اگر لیست ورودی یا خروجی تنظیم نشده باشد، دستگاههای آن دسته تحت تأثیر قرار نمیگیرند.
این یک خطا است که در شناسه دستگاه موجود نیست.
- پاسخ به تماس
عملکرد اختیاری
پارامتر
callback
به نظر می رسد:() => void
قول<باطل>
Chrome 116+Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به callback ارسال می شود حل می شود.
chrome.audio.setMute(
streamType: StreamType,
isMuted: boolean,
callback?: function,
)
حالت بی صدا را برای یک نوع جریان تنظیم می کند. حالت بیصدا برای همه دستگاههای صوتی با نوع پخش صوتی مشخص شده اعمال میشود.
- نوع جریان
نوع جریانی که برای آن حالت بی صدا باید تنظیم شود.
- خاموش است
بولی
مقدار جدید بی صدا.
- پاسخ به تماس
عملکرد اختیاری
پارامتر
callback
به نظر می رسد:() => void
قول<باطل>
Chrome 116+Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به callback ارسال می شود حل می شود.
chrome.audio.setProperties(
id: string,
properties: DeviceProperties,
callback?: function,
)
ویژگی های دستگاه ورودی یا خروجی را تنظیم می کند.
- شناسه
رشته
- خواص
- پاسخ به تماس
عملکرد اختیاری
پارامتر
callback
به نظر می رسد:() => void
قول<باطل>
Chrome 116+Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوعی که به callback ارسال می شود حل می شود.
chrome.audio.onDeviceListChanged.addListener(
callback: function,
)
وقتی دستگاههای صوتی تغییر میکنند، یا دستگاههای جدید اضافه میشوند یا دستگاههای موجود حذف میشوند، فعال میشود.
- پاسخ به تماس
تابع
پارامتر
callback
به نظر می رسد:(devices: AudioDeviceInfo[]) => void
- دستگاه ها
chrome.audio.onLevelChanged.addListener(
callback: function,
)
هنگامی که سطح صدا برای یک دستگاه صوتی فعال تغییر می کند، فعال می شود.
- پاسخ به تماس
تابع
پارامتر
callback
به نظر می رسد:(event: LevelChangedEvent) => void
- رویداد
chrome.audio.onMuteChanged.addListener(
callback: function,
)
هنگامی که وضعیت بی صدا ورودی یا خروجی صدا تغییر می کند فعال می شود. توجه داشته باشید که حالت بیصدا در کل سیستم است و مقدار جدید برای هر دستگاه صوتی با نوع پخش مشخص اعمال میشود.
- پاسخ به تماس
تابع
پارامتر
callback
به نظر می رسد:(event: MuteChangedEvent) => void
- رویداد