1/* 2 * Copyright (C) 2011 Google Inc. All rights reserved. 3 * 4 * Redistribution and use in source and binary forms, with or without 5 * modification, are permitted provided that the following conditions 6 * are met: 7 * 1. Redistributions of source code must retain the above copyright 8 * notice, this list of conditions and the following disclaimer. 9 * 2. Redistributions in binary form must reproduce the above copyright 10 * notice, this list of conditions and the following disclaimer in the 11 * documentation and/or other materials provided with the distribution. 12 * 13 * THIS SOFTWARE IS PROVIDED BY APPLE COMPUTER, INC. ``AS IS'' AND ANY 14 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 15 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 16 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE COMPUTER, INC. OR 17 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 18 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 19 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR 20 * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY 21 * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 22 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 23 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 24 */ 25 26enum TextTrackMode { "disabled", "hidden", "showing" }; 27enum TextTrackKind { "subtitles", "captions", "descriptions", "chapters", "metadata" }; 28 29[ 30 RuntimeEnabled=VideoTrack 31] interface TextTrack : EventTarget { 32 readonly attribute TextTrackKind kind; 33 readonly attribute DOMString label; 34 readonly attribute DOMString language; 35 36 readonly attribute DOMString id; 37 38 attribute TextTrackMode mode; 39 40 readonly attribute TextTrackCueList cues; 41 readonly attribute TextTrackCueList activeCues; 42 43 void addCue(TextTrackCue cue); 44 [RaisesException] void removeCue(TextTrackCue cue); 45 46 attribute EventHandler oncuechange; 47 48 [RuntimeEnabled=WebVTTRegions] readonly attribute VTTRegionList regions; 49 [RuntimeEnabled=WebVTTRegions] void addRegion(VTTRegion region); 50 [RaisesException, RuntimeEnabled=WebVTTRegions] void removeRegion(VTTRegion region); 51}; 52