AudioGraph Kelas

Referensi

Definisi

Ruang nama:: Windows.Media.Audio

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Edit

Mewakili grafik audio dari node input, output, dan submix yang terhubung yang memanipulasi dan merutekan audio.

public ref class AudioGraph sealed : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class AudioGraph final : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class AudioGraph : System.IDisposable

Public NotInheritable Class AudioGraph
Implements IDisposable

Warisan: Object Platform::Object IInspectable AudioGraph

Atribut: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Penerapan: IClosable IDisposable

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)
Kemampuan aplikasi	backgroundMediaRecording

Keterangan

Grafik audio terdiri dari simpul input, simpul output, dan simpul submix. Simpul input mencakup file audio, perangkat audio, dan kode yang menghasilkan data audio. Simpul output juga mencakup file audio, perangkat audio, dan kode yang memproses data audio. Saat grafik dimulai, data audio mengalir melalui grafik dari simpul input, melalui simpul submix apa pun, ke simpul output. Setiap simpul dapat memiliki nol atau lebih efek audio yang diterapkan ke data audio sebelum diteruskan ke simpul berikutnya. API terkait dan kelas ini memungkinkan Anda mengembangkan aplikasi audio dengan lebih cepat dan mudah daripada API COM XAudio2 tingkat rendah. Untuk panduan cara menggunakan grafik audio, lihat Grafik audio.

Dapatkan instans kelas ini dengan memanggil AudioGraph.CreateAsync.

Seluruh grafik audio harus beroperasi pada laju sampel yang sama. Sumber dapat memiliki laju sampel yang berbeda, tetapi segera disampel ulang.

Catatan

Jika tidak ada perangkat audio yang tersedia, grafik audio tidak dapat diinstansiasi.

AudioGraph tidak dapat diinstansiasi pada edisi N dan KN Windows 8 dan Windows 10, kecuali Paket Fitur Media opsional telah diinstal. Untuk informasi selengkapnya, lihat Paket Fitur Media untuk edisi Windows N.

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
1607	14393	CreateBatchUpdater
1607	14393	CreateDeviceInputNodeAsync(MediaCategory,AudioEncodingProperties,DeviceInformation,AudioNodeEmitter)
1607	14393	CreateFileInputNodeAsync(IStorageFile,AudioNodeEmitter)
1607	14393	CreateFrameInputNode(AudioEncodingProperties,AudioNodeEmitter)
1607	14393	CreateSubmixNode(AudioEncodingProperties,AudioNodeEmitter)
1803	17134	CreateMediaSourceAudioInputNodeAsync(MediaSource)
1803	17134	CreateMediaSourceAudioInputNodeAsync(MediaSource,AudioNodeEmitter)

Properti

CompletedQuantumCount	Mendapatkan jumlah kuantum yang telah selesai untuk grafik audio.
EncodingProperties	Mendapatkan properti pengodean untuk grafik audio.
LatencyInSamples	Mendapatkan latensi dalam sampel yang didukung grafik audio.
PrimaryRenderDevice	Mendapatkan perangkat render utama untuk grafik audio.
RenderDeviceAudioProcessing	Mendapatkan nilai yang menunjukkan mode pemrosesan audio untuk grafik audio.
SamplesPerQuantum	Mendapatkan jumlah sampel per kuantum tempat grafik audio saat ini beroperasi.

Metode

Close()	Menutup grafik audio dan membuang sumber daya terkait.
CreateAsync(AudioGraphSettings)	Membuat grafik audio dengan pengaturan tertentu.
CreateBatchUpdater()	Membuat AudioGraphBatchUpdater baru untuk AudioGraph yang menyebabkan semua modifikasi berikutnya pada semua simpul dalam grafik audio terakumulasi dan kemudian diterapkan setelah aplikasi Anda menutup atau membuang objek updater batch.
CreateDeviceInputNodeAsync(MediaCategory)	Membuat AudioDeviceInputNode yang memasukkan data audio ke dalam grafik audio dari perangkat input audio default, seperti mikrofon atau kartu audio.
CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties)	Membuat AudioDeviceInputNode yang memasukkan data audio ke dalam grafik audio dari perangkat input audio default seperti mikrofon atau kartu audio.
CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation)	Membuat AudioDeviceInputNode yang memasukkan data audio ke dalam grafik audio dari perangkat input audio yang ditentukan seperti mikrofon atau kartu audio.
CreateDeviceInputNodeAsync(MediaCategory, AudioEncodingProperties, DeviceInformation, AudioNodeEmitter)	Membuat AudioDeviceInputNode yang mendukung audio spasial yang memasukkan data audio ke dalam grafik audio dari perangkat input audio yang ditentukan seperti mikrofon atau kartu audio.
CreateDeviceOutputNodeAsync()	Membuat AudioDeviceOutputNode baru yang menghasilkan data audio dari grafik audio ke perangkat output default sistem, seperti speaker atau headphone.
CreateFileInputNodeAsync(IStorageFile)	Membuat AudioFileInputNode yang memasukkan data audio ke dalam grafik audio dari file penyimpanan.
CreateFileInputNodeAsync(IStorageFile, AudioNodeEmitter)	Membuat AudioFileInputNode yang mendukung audio spasial yang memasukkan data audio ke dalam grafik audio dari file penyimpanan.
CreateFileOutputNodeAsync(IStorageFile)	Membuat AudioFileOutputNode baru yang menghasilkan data audio dari grafik audio ke file penyimpanan yang ditentukan.
CreateFileOutputNodeAsync(IStorageFile, MediaEncodingProfile)	Membuat AudioFileOutuputNode baru yang menghasilkan data audio dari grafik audio ke file penyimpanan yang ditentukan.
CreateFrameInputNode()	Membuat AudioFrameInputNode yang memasukkan data audio yang dihasilkan oleh kode yang diimplementasikan aplikasi ke dalam grafik audio.
CreateFrameInputNode(AudioEncodingProperties)	Membuat AudioFrameInputNode, dengan properti pengodean yang ditentukan, yang memasukkan data audio yang dihasilkan oleh kode yang diimplementasikan aplikasi ke dalam grafik audio.
CreateFrameInputNode(AudioEncodingProperties, AudioNodeEmitter)	Membuat AudioFrameInputNode yang mendukung audio spasial, dengan properti pengodean yang ditentukan, yang memasukkan data audio yang dihasilkan oleh kode yang diimplementasikan aplikasi ke dalam grafik audio.
CreateFrameOutputNode()	Membuat AudioFrameOutputNode baru yang menghasilkan data audio dari grafik audio ke kode yang diimplementasikan aplikasi.
CreateFrameOutputNode(AudioEncodingProperties)	Membuat AudioFrameOutputNode baru, dengan properti pengodean yang ditentukan, yang menghasilkan data audio dari grafik audio ke kode yang diterapkan aplikasi.
CreateMediaSourceAudioInputNodeAsync(MediaSource)	Membuat MediaSourceAudioInputNode yang memasukkan data audio ke dalam grafik audio dari objek MediaSource yang disediakan.
CreateMediaSourceAudioInputNodeAsync(MediaSource, AudioNodeEmitter)	Membuat MediaSourceAudioInputNode yang mendukung audio spasial yang memasukkan data audio ke dalam grafik audio dari objek MediaSource yang disediakan.
CreateSubmixNode()	Membuat AudioSubmixNode yang mencampur output dari satu atau beberapa simpul grafik audio ke dalam satu output yang dapat dihubungkan ke simpul output atau simpul submix lainnya.
CreateSubmixNode(AudioEncodingProperties)	Membuat AudioSubmixNode yang mencampur output dari satu atau beberapa simpul grafik audio ke dalam satu output yang dapat dihubungkan ke simpul output atau simpul submix lainnya.
CreateSubmixNode(AudioEncodingProperties, AudioNodeEmitter)	Membuat AudioSubmixNode yang mendukung audio spasial yang mencampur output satu atau beberapa simpul grafik audio ke dalam satu output yang dapat dihubungkan ke simpul output atau simpul submix lainnya.
Dispose()	Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, merilis, atau mengatur ulang sumber daya yang tidak dikelola.
ResetAllNodes()	Mengatur ulang semua simpul dalam grafik audio.
Start()	Memulai grafik audio.
Stop()	Menghentikan grafik audio.

Acara

QuantumProcessed	Memberi tahu bahwa grafik audio telah memproses kuantum yang ditentukan.
QuantumStarted	Memberi tahu bahwa grafik audio telah mulai memproses kuantum baru.
UnrecoverableErrorOccurred	Memberi tahu kesalahan audio yang tidak dapat dipulihkan dalam operasi grafik audio.

Berlaku untuk

Bagikan melalui