Add guidance for defining a new source of MediaStreamTrack #988
Conversation
| and how they work with this source, | ||
| </li> | ||
| <li>describe how and when to [=set a track's muted state=] for this | ||
| <a>source</a>, |
There was a problem hiding this comment.
Is it clear enough that, if extension spec is not defining how/when muted changes, then muted will never change for tracks of the given source?
There was a problem hiding this comment.
Also need to define ended event and what the initial source muted state should be.
There was a problem hiding this comment.
Also file issues on other specs to define mute, initial mute and ended.
There was a problem hiding this comment.
Worrying about @youennf's comment about defining the default behavior - the current PR doesn't, which may be what we want to do in the first place.
Co-authored-by: youennf <[email protected]>
| {{MediaStreamTrack}}. If live samples are not made | ||
| available to the {{MediaStreamTrack}} it is muted.</p> | ||
| {{MediaStreamTrack}}. Live samples MUST NOT be made available to a | ||
| {{MediaStreamTrack}} while it is [=muted=].</p> |
There was a problem hiding this comment.
made available to track sinks?
There was a problem hiding this comment.
I'd like to minimize language changes in this PR, and this seems orthogonal.
Samples are observable through track.stats as well, so I think it's incorrect to say it only affects sinks. I think the existing language covers the track AND sinks, but if you disagree, please open a separate issue to clarify.
| to the associated events {{mute}} and {{unmute}}. The reasons for a | ||
| {{MediaStreamTrack}} to be muted are defined by its <a>source</a>.</p> | ||
| <p>For camera and microphone sources, the reasons to [=muted|mute=] are | ||
| [=implementation-defined=]. This allows user agents to implement privacy |
There was a problem hiding this comment.
I think this is a reasonable way to phrase it.
getusermedia.html
Outdated
| Agent has instructed the track to end for any reason) it is said to be | ||
| <p>After the application has invoked the {{MediaStreamTrack/stop()}} | ||
| method on a {{MediaStreamTrack}} object, or once the [=source=] of a | ||
| {{MediaStreamTrack}} ends production of live samples to its tracks, |
There was a problem hiding this comment.
for clarity, I think this should be "permanently ends production". If production can resume, the source is muted, not ended.
|
This issue had an associated resolution in WebRTC February 2024 meeting – 20 February 2024 (Add guidance for defining a new source of MediaStreamTrack):
|
Fixes #984.
Preview | Diff