SAMI 檔案範例

  • 發行項

[與此頁面相關聯的功能Windows 媒體播放機 SDK是舊版功能。 MediaPlayer已取代它。 MediaPlayer已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用MediaPlayer，而不是Windows 媒體播放機 SDK。 Microsoft 建議使用舊版 API 的現有程式碼盡可能重寫為使用新的 API。

下列範例程式碼是完整的 SAMI 檔案，其中包含一組封閉式標題文字，以及數個文字樣式和標題語言的類別宣告。

<SAMI>
<HEAD>
   <STYLE TYPE = "text/css">
   <!--
   /* P defines the basic style selector for closed caption paragraph text */
   P {font-family:sans-serif; color:white;}
   /* Source, Small, and Big define additional ID selectors for closed caption text */
   #Source {color: orange; font-family: arial; font-size: 12pt;}
   #Small {Name: SmallTxt; font-size: 8pt; color: yellow;}
   #Big {Name: BigTxt; font-size: 12pt; color: magenta;}
   /* ENUSCC and FRFRCC define language class selectors for closed caption text */
   .ENUSCC {Name: 'English Captions'; lang: en-US; SAMIType: CC;}
   .FRFRCC {Name: 'French Captions'; lang: fr-FR; SAMIType: CC;}
   -->
   </STYLE>
</HEAD>
<BODY>
   <!<entity type="mdash"/>- The closed caption text displays at 1000 milliseconds. -->
   <SYNC Start = 1000>
      <!-- English closed captions -->
      <P Class = ENUSCC ID = Source>Narrator
      <P Class = ENUSCC>Great reason to visit Seattle, brought to you by two out-of-staters.
      <!-- French closed captions -->
      <P Class = FRFRCC ID = Source>Narrateur
      <P Class = FRFRCC>Deux personnes ne venant la r&eacute;gion vous donnent de bonnes raisons de visiter Seattle.
</BODY>
</SAMI>

在 SAMI 檔案內定義的樣式符合元素、類別和識別碼的標準 CSS 選取器語法。 在 BODY 元素中，所有 P 元素都有在 STYLE 元素中為 P 元素選取器定義的樣式。 專案的類別屬性會指定 STYLE 元素中類別選取器所定義的該元素語言， (從句點開始的選取器) 。 類別選取器指定的語言名稱可以是任何字串。 具有指定 ID 屬性的專案會套用其他樣式，如 STYLE 元素中的識別碼選取器所指出， (以 # 字元開頭的選取器) 。

與Windows 媒體播放機物件模型搭配使用時，類別選取器會對應至ClosedCaption。SAMILang屬性，可用來指定標題的語言。 識別碼選取器會對應至 ClosedCaption。SAMIStyle 屬性，可用來指定標題將出現在其中的樣式。

如需建立 SAMI 檔案的詳細資訊，請參閱 Microsoft 網站上的瞭解 SAMI 1.0。

將隱藏式輔助字幕新增至數位媒體