ClosedCaption.SAMIFileName

[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 SAMIFileName menentukan atau mengambil nama file yang berisi informasi yang diperlukan untuk keterangan tertutup.

player.closedCaption.SAMIFileName

Kemungkinan Nilai

Properti ini adalah String baca/tulis.

Keterangan

File Synchronized Accessible Media Interchange (SAMI) harus menggunakan ekstensi nama file .smi atau .sami.

Jika Anda tidak menentukan nilai untuk SAMIFileName, properti ini mengambil string yang berisi nama file atau URL yang terkait dengan item media saat ini. Asosiasi ini dapat terjadi ketika file SAMI ditentukan menggunakan parameter URL sami , atau secara otomatis ketika file SAMI memiliki nama yang sama dengan nama file media digital (kecuali untuk ekstensi nama file). Jika tidak ada file SAMI yang terkait dengan media saat ini, properti ini mengambil string kosong ("").

Setelah Anda menentukan nilai untuk SAMIFileName, nilai tersebut bertahan hingga Anda menentukan nilai baru (atau hingga item media baru dibuka menggunakan parameter URL sami ). Oleh karena itu, Anda harus menentukan nilai baru untuk properti ini sebelum memutar setiap item media baru. Dengan begitu, nilai baru untuk SAMIFileName akan berlaku ketika item media berikutnya dibuka (atau ketika Player.close dipanggil). Menentukan nilai baru untuk SAMIFileName tidak berpengaruh untuk media saat ini.

Untuk menyebabkan Pemutar Media Windows kembali menggunakan file SAMI yang terkait dengan item media tertentu, tentukan nilai untuk SAMIFileName sama dengan string kosong ("") sebelum Anda memutar item media berikutnya.

Pemutar Media Windows 10 Seluler: Properti ini baca saja, dan selalu mengembalikan string kosong.

Contoh

Tiga contoh JScript berikut menggunakan ClosedCaption. SAMIFileName untuk menentukan nama file teks caption tertutup. Objek Pemutar dibuat dengan ID = "Pemutar".

// Display the closed captions from a website.
Player.closedCaption.SAMIFileName="https://www.proseware.com/ccsample.smi";

// Display the closed captions from a local network.
// You must add an escape sequence of a backslash for every original backslash.
Player.closedCaption.SAMIFileName="\\\\yourservername\\Public\\ccsample.smi";

// Display the closed captions from a file on a local drive.
// Be sure to add the appropriate escape sequences.
Player.closedCaption.SAMIFileName="C:\\WMSDK\\WMPSDK9\\samples\\media\\ccsample.smi";

Persyaratan

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

Lihat juga

Menambahkan Teks Tertutup ke Media Digital

Objek ClosedCaption

Player.close