Edit comment LC-3026 for Web Real-Time Communications Working Group

Quick access to LC-3009 LC-3010 LC-3011 LC-3012 LC-3013 LC-3014 LC-3015 LC-3016 LC-3017 LC-3018 LC-3019 LC-3020 LC-3021 LC-3022 LC-3023 LC-3024 LC-3025 LC-3026 LC-3027

Comment LC-3026

Comment Shortname:

Commenter:

On Behalf Of:

Message-id:

Section of the document concerned:

[Free text description]Document as a wholeMedia Capture and Streams Abstract Status of This Document 1. Introduction 2. Conformance 3. Terminology queue a task fires a simple event event handlers event handler event types source Constraints RTCPeerConnection 4. MediaStream API 4.1 Introduction 4.2 MediaStream MediaStream() When the constructor is invoked track set consumer active inactive 4.2.1 Constructors MediaStream 4.2.2 Attributes active of type boolean, readonly id of type DOMString, readonly id onactive of type EventHandler, onaddtrack of type EventHandler, oninactive of type EventHandler, onremovetrack of type EventHandler, 4.2.3 Methods addTrack() clone getAudioTracks() getTrackById() getTracks() getVideoTracks() removeTrack() 4.3 MediaStreamTrack 4.3.1 Life-cycle and Media Flow Life-cycle detached ended Media Flow Muted Enabled/disabled 4.3.2 Tracks and Constraints 4.3.3 Interface Definition 4.3.3.1 Attributes enabled of type boolean, MediaStreamTrack.enabled MediaStreamTrack.id MediaStreamTrack.kind MediaStreamTrack.label MediaStreamTrack.muted onended of type EventHandler, onmute of type EventHandler, onoverconstrained of type EventHandler, onunmute of type EventHandler, readonly readyState remote 4.3.3.2 Methods applyConstraints MediaStreamTrack.clone() getCapabilities getConstraints getSettings stop enum MediaStreamTrackState { "live", "ended" }; 4.3.4 Track Source Types enum SourceTypeEnum { "camera", "microphone" }; 4.3.5 MediaTrackSupportedConstraints 4.3.5.1 Dictionary MediaTrackSupportedConstraints Members aspectRatio of type boolean deviceId of type boolean echoCancellation of type boolean facingMode of type boolean frameRate of type boolean groupId of type boolean height of type boolean sampleRate of type boolean sampleSize of type boolean volume of type boolean width of type boolean 4.3.6 MediaTrackCapabilities 4.3.6.1 Dictionary MediaTrackCapabilities Members aspectRatio of type (double or DoubleRange) deviceId of type DOMString echoCancellation of type sequence<boolean> facingMode of type DOMString frameRate of type (double or DoubleRange) groupId of type DOMString height of type (long or LongRange) sampleRate of type (long or LongRange) sampleSize of type (long or LongRange) volume of type (double or DoubleRange) width of type (long or LongRange) 4.3.7 MediaTrackConstraints 4.3.7.1 Dictionary MediaTrackConstraints Members advanced of type sequence<MediaTrackConstraintSet> 4.3.7.2 Dictionary MediaTrackConstraintSet Members aspectRatio of type ConstrainDouble deviceId of type ConstrainDOMString echoCancellation of type ConstrainBoolean facingMode of type ConstrainDOMString frameRate of type ConstrainDouble groupId of type ConstrainDOMString height of type ConstrainLong sampleRate of type ConstrainLong sampleSize of type ConstrainLong volume of type ConstrainDouble width of type ConstrainLong 4.3.8 MediaTrackSettings 4.3.8.1 Dictionary MediaTrackSettings Members aspectRatio of type double deviceId of type DOMString echoCancellation of type boolean facingMode of type DOMString frameRate of type double groupId of type DOMString height of type long sampleRate of type long sampleSize of type long volume of type double width of type long 4.4 MediaStreamTrackEvent 4.4.1 Constructors MediaStreamTrackEvent 4.4.2 Attributes track 4.4.3 Dictionary MediaStreamTrackEventInit Members 5. The model: sources, sinks, constraints, and settings 6. MediaStreams as Media Elements 6.1 Direct Assignment to Media Elements 6.1.1 Attributes srcObject of type MediaStream, , nullable 6.2 Loading and Playing a MediaStream in a Media Element 6.3 Media Element Attributes when Playing a MediaStream 7. Error Handling 7.1 MediaStreamError All errors defined in this specificati... 7.1 MediaStreamError 7.1.1 Attributes constraintName of type DOMString, readonly , nullable message of type DOMString, readonly , nullable name of type DOMString, readonly 7.1.2 Constructors MediaStreamErrorEvent 7.1.3 Attributes 7.1.4 Dictionary MediaStreamErrorEventInit Members 7.2 Error names NotSupportedError PermissionDeniedError ConstraintNotSatisfiedError OverconstrainedError NotFoundError AbortError SourceUnavailableError 8. Event summary active inactive addtrack removetrack mute unmute overconstrained ended devicechange 9. Enumerating Local Media Devices 9.1 NavigatorUserMedia 9.1.1 Attributes mediaDevices of type MediaDevices, readonly 9.2 MediaDevices 9.2.1 Attributes ondevicechange of type EventHandler, 9.2.2 Methods enumerateDevices() 9.2.3 Access control model 9.3 Device Info 9.3.1 Attributes deviceId of type DOMString, readonly groupId of type DOMString, readonly kind of type MediaDeviceKind, readonly label of type DOMString, readonly enum MediaDeviceKind { "audioinput", "audiooutput",... videoinput 10. Obtaining local multimedia content 10.1 NavigatorUserMedia Interface Extensions Note The defi... 10.1 NavigatorUserMedia Interface Extensions Note partial interface NavigatorUserMedia { void getUserMedia... 10.1.1 Methods getUserMedia() 10.2 MediaDevices Interface Extensions 10.2.1 Methods getSupportedConstraints getUserMedia getUserMedia() 10.3 MediaStreamConstraints 10.3.1 Dictionary MediaStreamConstraints Members audio of type (boolean or MediaTrackConstraints), defaulting... video of type (boolean or MediaTrackConstraints), defaulting... 10.4 NavigatorUserMediaSuccessCallback 10.4.1 Callback NavigatorUserMediaSuccessCallback Parameters 10.5 NavigatorUserMediaErrorCallback 10.5.1 Callback NavigatorUserMediaErrorCallback Parameters 10.6 Implementation Suggestions Best Practice 1: Resource reservation Best Practice 2: Stored Permissions Best Practice 3: Handling multiple devices 11. Constrainable Pattern 11.1 Interface Definition 11.1.1 Attributes 11.1.2 Methods applyConstraints() settings dictionary fitness distance SelectSettings getCapabilities() getConstraints getSettings() 11.2 The Property Registry 11.2.1 Dictionary DoubleRange Members 11.2.2 Dictionary ConstrainDoubleRange Members 11.2.3 Dictionary LongRange Members 11.2.4 Dictionary ConstrainLongRange Members 11.2.5 Dictionary ConstrainBooleanParameters Members 11.2.6 Dictionary ConstrainDOMStringParameters Members 11.3 Capabilities Capabilities is a dictionary containing o... 11.3 Capabilities 11.4 Settings 11.5 Constraints and ConstraintSet 11.5.1 Dictionary Constraints Members 12. Examples 13. Privacy and Security Considerations 14. IANA Registrations 14.1 Track Constrainable Property Registrations sourceType deviceId groupId width height frameRate aspectRatio facingMode enum VideoFacingModeEnum { "user", "environment",... volume ConstrainDouble The volume or volume range, as a mul... sampleRate ConstrainLong The sample rate in samples per sec... sampleSize ConstrainLong The linear sample size in bits. Th... echoCancellation boolean When one or more audio streams is... 15. Change Log B. References B.1 Normative references [WEBIDL] B.2 Informative references
or

Refinement of the section concerned:

Status:

open proposal pending resolved_yes resolved_no resolved_partial other assigned to Nobody Aboba, Bernard Alvestrand, Harald Bateman, Adrian Bergkvist, Adam Berkovitz, Joe Boström, Henrik Brandstetter, Taylor Bruaroey, Jan-Ivar Budigere Ramakrishna, Karthik Budkiewicz, Arnaud Burnett, Daniel Caddoux, Romain Carlson, Eric Casas-sanchez, Miguel Cazeaux, Stephane Chen, Qiang Chen, Soares CHIANG, MENG-JUE Choi, Soo-Hyun Cohen, Mark DADAS, Mohammed Dixit, Shwetank Druta, Dan Eriksson, Göran fablet, youenn Froehlich, Michael Garcia, Gustavo Gombos, Laszlo Gouaillard, Alexandre Griffin, Keith Guduru, Kiran Håkansson, Stefan Hancke, Philipp Hato, Jumpei Hazaël-Massieux, Dominique Hiron, Aurélien Hofman, Mathieu Huang, Xiaolu Huang, Zixia Hutton, Andrew Jägenstedt, Philip Jansson, Christoffer Jennings, Cullen Jesup, Randell Johnston, Alan Kang, Shin-Gak Kuo, Tzuhao Lacourba, Vivien Lee, Kangchan Lee, WonSuk Loreto, Salvatore Mandyam, Giridhar Manson, Rob Melo de Sales, Leandro Mészáros, Mihály mine, shingo Nakagawa, Koichi Nandakumar, Suhas Noble, Jer O'Connor, Theresa Pradhan, Manas Rescorla, Eric Roach, Adam Romascanu, Dan Sato, Toshimitsu Schulte, Lennart Schwartz, Ben SHIM, HyukHoon Sim, Sherwin Singer, David Singh, Varun Smith, Michael[tm] Soref, Josh Stojiljkovic, Aleksandar Sun, Shijun Terriberry, Timothy Thatcher, Peter Thomson, Martin Uberti, Justin Urdaneta, Guido Uysaler, Emircan Velayutham, Senthil Venisse, Emmanuel Yasskin, Jeffrey zhou, yubo Zhu, Jianjun

Type: substantive editorial typo question general comment undefined

Resolution status:

Response drafted Resolution implemented Reply sent to commenter

Response status:

No response from Commenter yet Commenter approved disposition Commenter objected to disposition
Commenter's response (URI):

Comment:The first issue is I18N-ISSUE-464: http://www.w3.org/TR/2015/WD-mediacapture-streams-20150414/#widl-MediaStreamTrack-label The 'label' value is described as follows: -- User Agents MAY label audio and video sources (e.g., "Internal microphone" or "External USB Webcam"). The MediaStreamTrack.label attribute MUST return the label of the object's corresponding source, if any. If the corresponding source has or had no label, the attribute MUST instead return the empty string. -- Since the value is intended to contain natural language text, probably for consumption/display to the end-user, maybe it should be possible to determine or set the language (@lang) and base direction (@dir) of the text. This will allow the text to be displayed properly in different contexts: most text rendering systems depend on this information to do a good job, even within the same display context. In addition, it may be useful to allow multiple labels in different languages (although generally the source's label is applied by the user's user-agent, and so will be appropriately localized??) [1] https://www.w3.org/International/track/products/78 Addison Phillips Globalization Architect (Amazon Lab126) Chair (W3C I18N WG)

Related issues: (space separated ids)

WG Notes: This issue is thorny. The identifiers returned as "label" in present implementations are mainly from underlying drivers, and it seems impossible for an UA to reliably provide translations of these labels. A simple fallback seems like it's needed. Since the mediaDevices.enumerateDevices call is only defined on Navigator, we ask whether it's possible to state that the @lang attribute is window.navigator.language, and whether it's appropriate to determine @dir via the same method

Resolution: The Working Group feels the topic of localizing human readable strings in JavaScript needs to be solved at the platform level rather than in this particular specification. We tried getting input and insights from the Internationalization Working Group on how to progress such an addition to the platform, to no avail.

(Please make sure the resolution is adapted for public consumption)

Check to confirm deletion (not reversible)