AudioStateMonitor Kelas

Definisi

Ruang nama:

Windows.Media.Audio

Memungkinkan aplikasi UWP untuk menentukan apakah salah satu aliran audio aplikasi saat ini dibisukan atau volumenya dikurangi oleh sistem.

public ref class AudioStateMonitor sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 393216)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class AudioStateMonitor final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 393216)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class AudioStateMonitor

Public NotInheritable Class AudioStateMonitor

Warisan

Object Platform::Object IInspectable AudioStateMonitor

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10, version 1803 (diperkenalkan dalam 10.0.17134.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v6.0)

Keterangan

Windows secara dinamis mematikan suara atau menurunkan tingkat aliran audio sebagai respons terhadap peristiwa sistem. Misalnya, volume aliran render audio aplikasi podcast dapat diturunkan saat alarm berdering. Atau aplikasi perekaman audio mungkin telah mematikan suara streaming pengambilan saat aplikasi berpindah ke latar belakang. Kelas ini memungkinkan aplikasi untuk merespons perubahan dalam tingkat aliran audio mereka. Misalnya, aplikasi podcast dapat memilih untuk menjeda pemutaran saat tingkat suara diturunkan oleh sistem lalu melanjutkan pemutaran saat tingkat volume kembali normal. Atau, aplikasi perekaman audio dapat memilih untuk berhenti merekam saat aliran pengambilannya dibisukan.

Buat AudioStateMonitor dengan memanggil salah satu metode pabriknya yang menentukan aliran mana yang dipantau berdasarkan MediaCategory, AudioDeviceRole, ID perangkat audio terkait, dan apakah aliran menangkap atau merender audio.

Gunakan properti SoundLevel untuk menentukan tingkat suara aliran yang dipantau saat ini. Anda dapat memeriksa nilai properti ini, untuk menentukan apakah kategori aliran audio akan dibisukan atau volumenya diturunkan, sebelum memulai pengambilan atau pemutaran audio. Anda dapat mendaftarkan handler untuk peristiwa SoundLevelChanged untuk menerima pemberitahuan ketika tingkat suara untuk kategori aliran audio berubah, lalu memeriksa properti SoundLevel untuk menentukan tingkat audio baru saat ini.

Untuk informasi selengkapnya tentang menggunakan AudioStateMonitor di aplikasi UWP, lihat Mendeteksi dan merespons perubahan status audio.

Properti

SoundLevel

Mendapatkan nilai yang menunjukkan tingkat suara aliran audio saat ini yang dipantau oleh AudioStateMonitor.

Metode

CreateForCaptureMonitoring()	Menginisialisasi instans baru kelas AudioStateMonitor yang memantau tingkat suara untuk semua aliran pengambilan audio.
CreateForCaptureMonitoring(MediaCategory)	Menginisialisasi instans baru kelas AudioStateMonitor yang memantau tingkat suara untuk aliran pengambilan audio dengan MediaCategory yang ditentukan.
CreateForCaptureMonitoring(MediaCategory, AudioDeviceRole)	Menginisialisasi instans baru kelas AudioStateMonitor yang memantau tingkat suara untuk aliran pengambilan audio dengan MediaCategory dan AudioDeviceRole yang ditentukan.
CreateForCaptureMonitoringWithCategoryAndDeviceId(MediaCategory, String)	Menginisialisasi instans baru kelas AudioStateMonitor yang memantau tingkat suara untuk aliran pengambilan audio dengan MediaCategory tertentu yang menggunakan perangkat audio yang ditentukan.
CreateForRenderMonitoring()	Menginisialisasi instans baru kelas AudioStateMonitor yang memantau tingkat suara untuk semua aliran render audio.
CreateForRenderMonitoring(AudioRenderCategory)	Menginisialisasi instans baru kelas AudioStateMonitor yang memantau tingkat suara untuk aliran render audio dengan MediaCategory yang ditentukan.
CreateForRenderMonitoring(AudioRenderCategory, AudioDeviceRole)	Menginisialisasi instans baru kelas AudioStateMonitor yang memantau tingkat suara untuk merender aliran dengan MediaCategory dan AudioDeviceRole yang ditentukan.
CreateForRenderMonitoringWithCategoryAndDeviceId(AudioRenderCategory, String)	Menginisialisasi instans baru kelas AudioStateMonitor yang memantau tingkat suara untuk aliran render audio dengan MediaCategory tertentu yang menggunakan perangkat audio yang ditentukan.

Acara

SoundLevelChanged

Terjadi ketika sistem mengubah tingkat suara aliran audio yang dipantau oleh AudioStateMonitor.