MediaCapture.SetEncodingPropertiesAsync Metode

Referensi

Definisi

Ruang nama:: Windows.Media.Capture

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

Secara asinkron mengatur properti pengodean media.

public:
 virtual IAsyncAction ^ SetEncodingPropertiesAsync(MediaStreamType mediaStreamType, IMediaEncodingProperties ^ mediaEncodingProperties, MediaPropertySet ^ encoderProperties) = SetEncodingPropertiesAsync;

IAsyncAction SetEncodingPropertiesAsync(MediaStreamType const& mediaStreamType, IMediaEncodingProperties const& mediaEncodingProperties, MediaPropertySet const& encoderProperties);

public IAsyncAction SetEncodingPropertiesAsync(MediaStreamType mediaStreamType, IMediaEncodingProperties mediaEncodingProperties, MediaPropertySet encoderProperties);

function setEncodingPropertiesAsync(mediaStreamType, mediaEncodingProperties, encoderProperties)

Public Function SetEncodingPropertiesAsync (mediaStreamType As MediaStreamType, mediaEncodingProperties As IMediaEncodingProperties, encoderProperties As MediaPropertySet) As IAsyncAction

Parameter

mediaStreamType: MediaStreamType

Jenis data media yang diwakili aliran, seperti video atau audio.

mediaEncodingProperties: IMediaEncodingProperties

Properti untuk pengodean media.

encoderProperties: MediaPropertySet

Properti untuk encoder.

Mengembalikan

IAsyncAction

Objek yang digunakan untuk mengontrol operasi asinkron.

Persyaratan Windows

Kemampuan aplikasi

backgroundMediaRecording

Keterangan

Metode ini mengatur properti pengodean encoder yang memproses data sebelum diteruskan ke CaptureElement untuk ditampilkan, ditulis ke IRandomAccessStream atau StorageFile, atau dikirimkan ke sink media kustom. Metode ini tidak mengubah konfigurasi sumber data, yang merupakan perangkat kamera. Dimungkinkan untuk mengatur properti pengodean ke resolusi yang tidak didukung secara asli oleh kamera. Dalam hal ini, alur MediaCapture akan menggunakan encoder untuk melakukan konversi ke format yang diminta. Perhatikan bahwa konversi ini memang mengonsumsi sumber daya sistem dan dapat mengakibatkan performa yang buruk atau bahkan kesalahan, terutama pada perangkat yang dengan akselerasi grafik terbatas atau tidak ada. Untuk skenario umum, disarankan agar Anda memilih resolusi yang didukung oleh kamera yang paling dekat dengan resolusi yang Anda inginkan. Anda bisa mendapatkan daftar resolusi yang didukung perangkat tangkap dengan memanggil VideoDeviceController.GetAvailableMediaStreamProperties. Untuk informasi selengkapnya, lihat Mengatur format, resolusi, dan kecepatan bingkai untuk MediaCapture dan Sampel Resolusi Kamera.

Catatan

SetEncodingPropertiesAsync hanya akan berhasil ketika aliran pratinjau default dalam status streaming, yaitu setelah StartPreviewAsync berhasil dipanggil. Jika SetEncodingPropertiesAsync dipanggil saat objek MediaCapture mengalirkan video dari MediaFrameSource melalui MediaPlayerElement atau MediaFrameReader, panggilan ini akan gagal.

Untuk memutar aliran rekaman atau pratinjau, gunakan GUID yang ditentukan oleh MF_MT_VIDEO_ROTATION untuk menambahkan metadata ke aliran. Perhatikan bahwa rotasi ini dilakukan oleh konsumen aliran, seperti CaptureElement atau aplikasi pemutar video, sementara piksel aktual dalam aliran masih mempertahankan orientasi aslinya. Untuk panduan cara menangani orientasi saat menggunakan kamera, lihat Menangani orientasi perangkat dengan MediaCapture.

Untuk mengubah properti perangkat pengambilan, gunakan VideoDeviceController.SetMediaStreamPropertiesAsync.

Berlaku untuk