Controls.currentPositionTimecode

[Fitur yang terkait dengan halaman ini, Pemutar Media Windows SDK, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer. MediaPlayer telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer alih-alih Pemutar Media Windows SDK, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Properti currentPositionTimecode menentukan atau mengambil posisi saat ini dalam item media saat ini menggunakan format kode waktu. Properti ini saat ini mendukung kode waktu SMPTE.

player.controls.currentPositionTimecode
      

Kemungkinan Nilai

Properti ini adalah String baca/tulis.

Keterangan

Kode waktu SMPTE menyediakan cara standar untuk mengidentifikasi bingkai video individual, yang berguna untuk menyinkronkan pemutaran. Jika file media digital mendukung kode waktu SMPTE, Pemutar Media Windows dapat mengambil informasi posisi kode waktu saat ini atau mencari bingkai video yang diidentifikasi oleh String kode waktu tertentu.

Kode waktu SMPTE mengidentifikasi bingkai tertentu dengan jumlah jam, menit, detik, dan bingkai yang memisahkannya dari bingkai referensi tertentu yang ditetapkan sebagai nol waktu. Biasanya bingkai nol waktu adalah awal file dan nilai kode waktu SMPTE tertentu mewakili waktu yang berlalu sejak awal file.

String kode waktu dalam format [range]hh:mm:ss. ff di mana [rentang] mewakili rentang, hh mewakili jam, mm mewakili menit, s mewakili detik, dan ff mewakili bingkai. Saat menentukan nilai menggunakan currentPositionTimecode, Anda harus menyertakan semua delapan digit menggunakan nol sebagai tempat penampung.

Penentu [rentang] sesuai dengan anggota wRange dari struktur WMT_TIMECODE_EXTENSION_DATA Format Media Windows. Untuk informasi selengkapnya tentang rentang kode waktu, lihat SDK Format Media Windows.

Menentukan dan mengambil currentPositionTimecode hanya didukung untuk file yang berisi informasi kode waktu SMPTE.

Contoh

Contoh kode berikut menentukan currentPositionTimecode sebagai 1 jam, nol menit, 30 detik, dan 5 bingkai. Objek Pemutar dibuat dengan ID = "Pemutar".

// Seek to a frame using SMPTE time code.
Player.controls.currentPositionTimecode = "[00000]01:00:30.05";

Persyaratan

Persyaratan	Nilai
Versi	Pemutar Media Windows Seri 9 atau yang lebih baru.
DLL	Wmp.dll

Lihat juga

Objek Kontrol