SAMI

From HandWiki
Revision as of 19:48, 6 February 2024 by MainAI5 (talk | contribs) (update)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Synchronized Accessible Media Interchange
Filename extension.smi, .sami
Developed byMicrosoft
Initial release25 June 1998; 26 years ago (1998-06-25)
Type of formatTimed text
Extended fromHTML
Open format?Proprietary

Synchronized Accessible Media Interchange (SAMI) is a Microsoft accessibility initiative released in the summer of 1998.[1] The structured markup language is designed to simplify creating subtitles for media playback on a PC.

Overview

A SAMI file provides closed caption support for multimedia formats. Generally, a multimedia file (such as a video or a sound file) is played by a media player such as Windows Media Player. Media players that support closed captioning and SAMI format may display the contents of the included SAMI file.

A SAMI file is a plain text file and therefore can be created or modified in any text editor. Its structure is very similar to HTML. The files may have either .smi or .sami filename extensions, although using .smi may cause a filename extension collision, since Synchronized Multimedia Integration Language (SMIL) files and Macintosh self mounting images also use this filename extension.

Supported HTML tags and CSS

SAMI format is similar to HTML and CSS; in fact, SAMI implements a subset of both. SAMI does not require strict tag matching.

Valid HTML tags in SAMI[2]
Name Description
B Bold text style
BASEFONT Base font size
BDO I18N BiDi override
BIG Large text style
BLOCKQUOTE Long quotation
BR Forced line break
CAPTION Table caption
CENTER Shorthand for DIV align=center
COL Table column
COLGROUP Table column group
DD Definition description
DIV Generic language/style container
DL Definition list
DT Definition term
FONT Local change to font
H1 Heading
H2 Heading
H3 Heading
H4 Heading
H5 Heading
H6 Heading
HR Horizontal rule
I Italic text style
IMG Embedded image
LI List item
OL Ordered list
P Paragraph
PRE Preformatted text
Q Short inline quotation
S Strike-through text style
SMALL Small text style
SPAN Generic language/style container
STRIKE Strike-through text
SUB Subscript
SUP Superscript
TABLE N/A
TBODY Table body
TD Table data cell
TFOOT Table footer
TH Table header cell
THEAD Table header
TR Table row
TT Teletype or monospaced text style
U Underlined text style
UL Unordered list

Example

Here's an example SAMI file. It sets the time to milliseconds. It uses CSS for formatting both the source and text lines and it supports language selection. (English and faux-French shown). Each SYNC block sets the start time for the caption. A new caption is displayed every second (1000ms). The Class= identifies the language. The ID=Source (matching the #Source in the CSS identifier definition) indicates the source/speaker line; the default is the closed caption. The identifier name need not be "Source"; it may be any name.

The Microsoft parser is fragile. Formatting information can be added to the closed caption information, but adding format information to the source line can have unpredictable results. Defining more than one ID can have unpredictable results.

<SAMI>

<HEAD>
<TITLE>SAMI Example</TITLE>

<SAMIParam>
  Media {cheap44.wav}
  Metrics {time:ms;}
  Spec {MSFT:1.0;}
</SAMIParam>

<STYLE TYPE="text/css">
<!--
  P { font-family: Arial; font-weight: normal; color: white; background-color: black; text-align: center; }

  #Source {color: red; background-color: blue; font-family: Courier; font-size: 12pt; font-weight: normal; text-align: left; }

  .ENUSCC { name: English; lang: en-US ; SAMIType: CC ; }
  .FRFRCC { name: French;  lang: fr-FR ; SAMIType: CC ; }
-->
</STYLE>

</HEAD>

<BODY>

<!-- Open play menu, choose Captions and Subtiles, On if available -->
<!-- Open tools menu, Security, Show local captions when present -->

<SYNC Start=0>
  <P Class=ENUSCC ID=Source>The Speaker</P>
  <P Class=ENUSCC>SAMI 0000 text</P>

  <P Class=FRFRCC ID=Source>Le narrateur</P>
  <P Class=FRFRCC>Texte SAMI 0000</P>
</SYNC>

<SYNC Start=1000>
  <P Class=ENUSCC>SAMI 1000 text</P>
  <P Class=FRFRCC>Texte SAMI 1000</P>
</SYNC>

<SYNC Start=2000>
  <P Class=ENUSCC>SAMI 2000 text</P>
  <P Class=FRFRCC>Texte SAMI 2000</P>
</SYNC>

<SYNC Start=3000>
  <P Class=ENUSCC>SAMI 3000 text</P>
  <P Class=FRFRCC>Texte SAMI 3000</P>
</SYNC>

</BODY>
</SAMI>

Association with media

The player needs to know how to associate a particular media file to a SAMI file. Sometimes that is achieved by using the same filename as the underlying media file. For example, when Windows Media Player (WMP) opens the sound file cheap44.wav, it checks to see if the file cheap44.smi exists in the same folder. If it does, WMP uses that file to display closed captions.

Alternatively, the association can be made explicit using an entry in an Advanced Stream Redirector (ASX) file. The user opens the ASX file instead.

<asx version="3.0" previewmode="No" >
  <abstract>ASXHEAD This is the shows abstract</abstract>
  <title>ASXHEAD The show title goes here</title>
  <author>Author Name</author>
  <copyright>(c) 2002 - company name</copyright>
  <entry>
    <ref href="cheap44.wav?sami=cheap44.smi" />
    <abstract>ASX This is the clips abstract</abstract>
    <title>ASX The title for the clip goes here</title>
    <author>ASX Your Name</author>
    <copyright>ASX (c) 2000 - company name</copyright>
  </entry>
</asx>

Software support

The following is a list of software that can play SAMI along with multimedia content:

See also

  • Subtitle editor

References

  1. "Adding Closed Captioning to Your Multimedia Programs". Microsoft Developer News & Articles (Microsoft). September 1998. http://www.microsoft.com/enable/dev/msdn8.htm. 
  2. "Understanding SAMI 1.0". Microsoft Developer Network. Microsoft Corporation. February 2003. http://msdn.microsoft.com/en-us/library/ms971327.aspx. Retrieved 14 June 2011. 

Further reading

  1. Gunderson, Jon (14 March 2003). "SAMI and Quicktime Captioning". The Illinois Center for Information Technology Accessibility. University of Illinois at Urbana–Champaign. http://cita.disability.uiuc.edu/presentations/2003-03-14-HCC/part2/index.html. Retrieved 14 June 2011. 
  2. "Creating a SAMI File". Captioning for Windows Media. WebAIM. http://webaim.org/techniques/captions/windows/sami. Retrieved 14 June 2011. 
  3. "Software for Creating Captions". WebAIM. http://webaim.org/techniques/captions/software. Retrieved 14 June 2011.