Korzystanie z punktów sygnalizacji razem z podpisami

W metadanych pliku FLV punkt sygnalizacji jest reprezentowany przez obiekt z następującymi właściwościami: name , time , type i parameters . Punkty sygnalizacji stosowane w składniku FLVPlaybackCaptioning języka ActionScript mają następujące atrybuty:

name

Właściwość name jest ciągiem znaków, który zawiera nazwę przypisaną do punktu sygnalizacji. Właściwość name musi rozpoczynać się od przedrostka fl.video.caption.2.0. , po którym musi następować ciąg. Ciąg jest szeregiem dodatnich liczb całkowitych zwiększanych o jeden w każdym wystąpieniu, tak aby nazwy punktów były unikatowe. Przedrostek zawiera numer wersji zgodny z numerem wersji składnika FLVPlayback. W przypadku programu Adobe Flash CS4 i nowszych wersji należy ustawić numer wersji na 2.0 .

time

Właściwość time to czas, w którym podpis powinien zostać wyświetlony.

type

Właściwość type to ciąg znaków o wartości "event" .

parameters

Właściwość parameters to tablica, która może zawierać następujące pary nazwa-wartość:

text:String

Tekst podpisu w formacie HTML. Tekst jest przekazywany bezpośrednio do właściwości TextField.htmlText . Składnik FLVPlaybackCaptioning obsługuje opcjonalną właściwość text: n umożliwiającą używanie wielu wersji językowych. Więcej informacji zawiera sekcja Obsługa wielu wersji językowych przy użyciu osadzonych punktów sygnalizacji .

endTime:Number

Czas, w którym podpis powinien zniknąć. Jeśli wartość tej właściwości nie zostanie określona, składnik FLVPlaybackCaptioning przyjmuje, że nie jest ona liczbą (NaN), a podpis jest wyświetlany aż do zakończenia pliku FLV (momentu, w którym instancja FLVPlayback wywoła zdarzenie VideoEvent.COMPLETE ) . Wartość właściwości endTime:Number należy podać w sekundach.

backgroundColor:uint

Ten parametr ustawia właściwość TextField.backgroundColor . Ta właściwość jest opcjonalna.

backgroundColorAlpha:Boolean

Jeśli składnik alfa wartości backgroundColor jest równy 0%, dokonywane jest przypisanie TextField.background = !backgroundColor . Ta właściwość jest opcjonalna.

wrapOption:Boolean

Ten parametr ustawia właściwość TextField.wordWrap. Ta właściwość jest opcjonalna.

Jeśli nie jest dostępny plik XML w formacie Timed Text zawierający podpisy dla pliku FLV, można utworzyć podpisy, korzystając ze skojarzonego pliku XML zawierającego podpisy sterowane przez osadzone punkty sygnalizacji zdarzeń. Przykładowy plik XML opracowano przy założeniu, że użytkownik wykonał następujące czynności w celu utworzenia osadzonych punktów sygnalizacji zdarzeń w pliku wideo:

• Dodaj pliki sygnalizacji zdarzeń (zgodne ze standardami stosowanymi w składniku FLVPlaybackCaptioning) i zakoduj wideo.

• W programie Flash przeciągnij składnik FLVPlayback oraz składnik FLVPlaybackCaptioning na stół montażowy.

• Ustaw właściwości źródła składnika FLVPlayback i FLVPlaybackCaptioning (lokalizację pliku FLV i lokalizację pliku XML).

• Dokonaj publikacji.

  Poniższy przykład importuje plik XML do kodera:

  <?xml version="1.0" encoding="UTF-8" standalone="no" ?> 
  <FLVCoreCuePoints> 
   
      <CuePoint> 
          <Time>9136</Time> 
          <Type>event</Type> 
          <Name>fl.video.caption.2.0.index1</Name> 
          <Parameters> 
              <Parameter> 
                  <Name>text</Name> 
                  <Value><![CDATA[Captioning text for the first cue point]]></Value> 
              </Parameter> 
          </Parameters> 
      </CuePoint> 
   
      <CuePoint> 
          <Time>19327</Time> 
          <Type>event</Type> 
          <Name>fl.video.caption.2.0.index2</Name> 
          <Parameters> 
              <Parameter> 
                  <Name>text</Name> 
                  <Value><![CDATA[Captioning text for the second cue point]]></Value> 
              </Parameter> 
          </Parameters> 
      </CuePoint> 
   
      <CuePoint> 
          <Time>24247</Time> 
          <Type>event</Type> 
          <Name>fl.video.caption.2.0.index3</Name> 
          <Parameters> 
              <Parameter> 
                  <Name>text</Name> 
                  <Value><![CDATA[Captioning text for the third cue point]]></Value> 
              </Parameter> 
          </Parameters> 
      </CuePoint> 
   
      <CuePoint> 
          <Time>36546</Time> 
          <Type>event</Type> 
          <Name>fl.video.caption.2.0.index4</Name> 
          <Parameters> 
              <Parameter> 
                  <Name>text</Name> 
                  <Value><![CDATA[Captioning text for the fourth cue point]]></Value> 
              </Parameter> 
          </Parameters> 
      </CuePoint> 
   
  </FLVCoreCuePoints>

  Składnik FLVPlaybackCaptioning obsługuje także wiele wersji językowych napisów realizowanych przy użyciu osadzonych punktów sygnalizacji. Więcej informacji zawiera sekcja Obsługa wielu wersji językowych przy użyciu osadzonych punktów sygnalizacji .

Właściwość track składnika FLVPlaybackCaptioning umożliwia utworzenie wielu wersji językowych przy użyciu osadzonych punktów sygnalizacji, o ile tylko plik XML w formacie Timed Text jest zgodny ze standardami punktów sygnalizacji stosowanymi w składniku FLVPlaybackCaptioning. (Więcej informacji zawiera sekcja Omówienie standardów punktów sygnalizacji używanych w składniku FLVPlaybackCaptioning .) Jednak FLVPlaybackCaptioning nie obsługuje wielu wersji językowych podpisów w odrębnych plikach XML. Aby użyć właściwości track , należy ustawić ją na wartość różną od 0. Na przykład, w wypadku ustawienia właściwości na 1 ( track == 1) , składnik FLVPlaybackCaptioning będzie szukał parametrów punktów sygnalizacji. W razie nieznalezienia dopasowanych parametrów, użyta zostanie właściwość text z parametrów punktu sygnalizacji. Więcej informacji zawiera opis właściwości track w Skorowidzu języka ActionScript 3.0 dla programu Flash Professional .