Metode Media.getMarkerTime

Artikel
06/21/2023

[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.]

Metode getMarkerTime mengambil waktu penanda pada indeks yang ditentukan.

Sintaks

retVal = Media.getMarkerTime(
  markerNum
)

Parameter

markerNum [in]: Angka (panjang) yang menentukan indeks penanda.

Mengembalikan nilai

Metode ini mengembalikan Angka (ganda) yang menentukan lokasi penanda dalam hitungan detik dari awal klip.

Keterangan

Metode ini mengembalikan NULL jika penanda yang ditentukan tidak ada.

Beberapa item media digital tidak memuat penanda. Gunakan markerCount untuk mengetahui berapa banyak penanda dalam klip saat ini.

Nomor indeks penanda dimulai dari 1.

Untuk menggunakan metode ini, diperlukan akses baca ke pustaka. Untuk informasi selengkapnya, lihat Akses Pustaka.

Contoh

Contoh JScript berikut menggunakan Media. getMarkerTime untuk mengisi elemen HTML TEXTAREA bernama MTIMES dengan lokasi setiap penanda. Objek Pemutar dibuat dengan ID = "Pemutar".

// Get the number of markers in the current media item.
var mcount = Player.currentMedia.markerCount;

// Verify that at least one marker exists in the current media item.
if (mcount > 0){

// Loop through the marker list.
for (var i = 1;i < mcount + 1; i++){

   // Print the message to the text area.
   MTIMES.value += "Marker number " + i + " occurs at ";
   MTIMES.value += Player.currentMedia.getMarkerTime(i);
   MTIMES.value += " second(s).";
   MTIMES.value += "\n";
}

Persyaratan

Persyaratan	Nilai
Versi	Pemutar Media Windows versi 7.0 atau yang lebih baru.
DLL	Wmp.dll

Lihat juga

Objek Media
Media.getMarkerName
Media.markerCount
Settings.mediaAccessRights
Settings.requestMediaAccessRights

Share via