1/* 2 * Copyright (C) 2011 Google Inc. All rights reserved. 3 * Copyright (C) 2013 Apple Inc. All rights reserved. 4 * 5 * Redistribution and use in source and binary forms, with or without 6 * modification, are permitted provided that the following conditions 7 * are met: 8 * 1. Redistributions of source code must retain the above copyright 9 * notice, this list of conditions and the following disclaimer. 10 * 2. Redistributions in binary form must reproduce the above copyright 11 * notice, this list of conditions and the following disclaimer in the 12 * documentation and/or other materials provided with the distribution. 13 * 14 * THIS SOFTWARE IS PROVIDED BY APPLE INC. AND ITS CONTRIBUTORS ``AS IS'' AND ANY 15 * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 16 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 17 * DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR ITS CONTRIBUTORS BE LIABLE FOR ANY 18 * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 19 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 20 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON 21 * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 22 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 23 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 24 */ 25 26enum MediaStreamTrackState { "new", "live", "ended" }; 27 28[ 29 Conditional=MEDIA_STREAM, 30 EventTarget, 31 ActiveDOMObject, 32 SkipVTableValidation, 33] interface MediaStreamTrack { 34 readonly attribute DOMString kind; 35 readonly attribute DOMString id; 36 readonly attribute DOMString label; 37 attribute boolean enabled; 38 readonly attribute boolean muted; 39 attribute EventListener onmute; 40 attribute EventListener onunmute; 41 readonly attribute boolean _readonly; 42 readonly attribute boolean remote; 43 readonly attribute MediaStreamTrackState readyState; 44 attribute EventListener onstarted; 45 attribute EventListener onended; 46 47 [CallWith=ScriptExecutionContext, RaisesException] static void getSources(MediaStreamTrackSourcesCallback callback); 48 49 MediaTrackConstraints getConstraints(); 50 51 MediaSourceStates states(); 52 53 MediaStreamCapabilities getCapabilities(); // returns either AllVideoCapabilities or AllAudioCapabilities 54 55 void applyConstraints(Dictionary constraints); 56 57 attribute EventListener onoverconstrained; 58 MediaStreamTrack clone(); 59 [ImplementedAs=stopProducingData] void stop(); 60 61 // EventTarget interface 62 void addEventListener(DOMString type, 63 EventListener listener, 64 optional boolean useCapture); 65 void removeEventListener(DOMString type, 66 EventListener listener, 67 optional boolean useCapture); 68 [RaisesException] boolean dispatchEvent(Event event); 69}; 70 71