Replacing non-streaming audio with live audio #1661

carlosapaduarte · 2021-06-25T16:32:23Z

Updating 'audio element content has text alternative' (#e7aa44) so that it no longer uses the non-streaming definition which was found to be inaccurate

I'm looking for comments on:

The appropriateness of the expectation in the new atomic rule that checks if the audio content is live
Suggestions on resources to use for the passed example

After getting this change approved I'll open a new PR changing the other rules that also use the non-streaming definition

Need for Final Call:
This will require a 2 weeks Final Call

How to Review And Approve

Go to the “Files changed” tab
Here you will have the option to leave comments on different lines.
Once the review is completed, find the “Review changes” button in the top right, select “Approve” (if you are really confident in the rule) or "Request changes" and click “Submit review”.
Make sure to also review the proposed Final Call period. In case of disagreement, the longer period wins.

ajanec01 · 2021-06-29T08:37:12Z

I must've missed that part, what's inaccurate with "non-streaming"?

carlosapaduarte · 2021-06-29T08:38:50Z

This: #1446 (comment)

Jym77 · 2021-07-01T10:39:54Z

_rules/audio-is-live-213x3x.md

+- playing; or,
+- has a "play button" that is [visible][] and [included in the accessibility tree][].
+
+**Note:** A play button is an interactive element that when activated, plays the audio.


We're trying to cut down on notes these days. Should that be moved to a definition?
Maybe "play button" = "instrument to play a media"?

Jym77 · 2021-07-01T10:48:29Z

_rules/audio-is-live-213x3x.md

+
+## Expectation 
+
+The target element's [media resource](https://html.spec.whatwg.org/multipage/media.html#media-resource) is being broadcasted in real time without being first recorded and stored on the origin server.


"real time" is maybe a bit too strong since many "lives" are actually delayed by a few seconds to give editor an emergency hatch in case of accidents (broadcast delay).

Which does open a can of worms of what "live" actually means. WCAG's definition does mention the broadcast delay, so we should definitely accept it. But then how long of a broadcast delay is enough to be considered "pre recorded" and require captions… ?

Changing the expectation.

Jym77 · 2021-07-01T10:49:38Z

_rules/audio-is-live-213x3x.md

+
+## Background
+
+- [Understanding SC 1.2.1:Audio-only and Video-only (Prerecorded)](https://www.w3.org/WAI/WCAG21/Understanding/audio-only-and-video-only-prerecorded)


There are many SC about pre recorded media. We should list all or none (or maybe you plan to add the rest when the atomic rule is added to the other composites)

I think I'll address this one after sorting out this rule.

Jym77 · 2021-07-01T10:51:27Z

_rules/audio-is-live-213x3x.md

+This rule applies to every `audio` element that is:
+
+- playing; or,
+- has a "play button" that is [visible][] and [included in the accessibility tree][].


This may be an artefact of the composite we currently work on. I am not sure about this condition. The rule could be very generic on any playing media.
Of course, not clear whether it's easier to first work on the specific version for this composite and then extend, or try to come up with the generic version immediately…

It sounds reasonable to have an atomic for all media, but I'll also address this after sorting this rule first.

Jym77 · 2021-07-01T10:57:40Z

_rules/audio-is-live-213x3x.md

+
+#### Passed Example 1
+
+This `audio` element plays a live media resource.


I agree that it is hard to find an institutional live media (audio or video)…
My best shot would be some "tourist" webcam that might be set up by cities or states (i.e. not private companies) and thus we could arguably endorse…

Something like https://www.skylinewebcams.com/en/live-cams-category/city-cams.html but we need to make sure of who is sharing the content 🤔

Jym77 · 2021-07-22T11:49:03Z

_rules/audio-is-live-213x3x.md


 ## Expectation 

-The target element's [media resource](https://html.spec.whatwg.org/multipage/media.html#media-resource) is being broadcasted in real time without being first recorded and stored on the origin server.
+For each test target one of the following is true:
+- it is not possible to [seek][] the end of the target element's [media resource][]; or 


I like that 👍
OTOH, I'm not sure it's possible to "not be possible to seek". The algorithm seems to always return (possibly after doing nothing). Would that rather be part of the second bullet (and so the first can be removed)?

I believe you are correct. I've updated the expectation accordingly.

Addresses https://github.com/act-rules/act-rules.github.io/pull/1661/files#r674724648

updated

carlosapaduarte · 2021-09-06T18:56:33Z

Updated rule, now with a working example.

Jym77 · 2021-09-09T09:05:18Z

_rules/audio-is-live-213x3x.md

+
+This `audio` element plays a live media resource by streaming the audio from the device's microphone.
+
+This example requires a browser supporting the experimental MediaStreamTrack API. The browser must be authorized to access a microphone. You can successfully test this example on Google Chrome with the flag --enable-blink-features=WebCodecs,MediaStreamInsertableStreams


I think we should (also) put that text inside the HTML page of the example itself.
That way, (manual) testers that navigate to the example's page (without necessarily going through the ACT rules page) would be able to see that text and act accordingly.

This now seems related to #1679 since "give access to your mic" sounds a bit like a test instruction 🤔

Moved the note to the example so that manual testers are aware of the instructions

Added a test instructions section after the description of the example

Jym77 · 2021-09-09T09:07:01Z

_rules/audio-is-live-213x3x.md

+
+#### Passed Example 1
+
+This `audio` element plays a live media resource by streaming the audio from the device's microphone.


Also, have you tested that by "seeking" the end, to make sure this matches the expectation?
Wondering if the "seek" bit should be used also in examples descriptions 🤔

I just found that MediaStream is not seekable! https://w3c.github.io/mediacapture-main/#mediastreams-in-media-elements
I will add this to the expectation and the example's description.

And I suppose this lands us again exactly where we were before... needing to find a live stream that we can use in the example 😞

daniel-montalvo · 2023-09-18T15:15:21Z

_rules/audio-is-live-213x3x.md

+	</script>
+</html>
+```
+


I am assuming we are expanding these passed examples with real streaming audios/videos of broadcasting orgs, right?

That was the main idea.

As was also mentioned in TPAC, we might want to explore the possibility of W3C hosting a streaming server where we could serve the examples (we would just loop one of the videos we already use).

replacing non-streaming audio with live audio - initial commit

ab1c358

carlosapaduarte added Rule Update Use this label for an existing rule that is being updated Rule Use this label for a new rule that does not exist already reviewers wanted labels Jun 25, 2021

carlosapaduarte requested review from WilcoFiers, ajanec01, Jym77 and ShadowBB June 25, 2021 16:32

Update spelling-ignore.yml

ee235af

carlosapaduarte mentioned this pull request Jun 25, 2021

All audio and video are "non streaming" (afb423, e7aa44, 2eb176, eac66b, c5a4ea, ab4d13, 1ea59c, f51b46, f196ce, c3232f, fd26cf, d7ba54, ac7dc6, ee13b5, 1ec09b, 1a02b0) #1446

Open

Jym77 reviewed Jul 1, 2021

View reviewed changes

carlosapaduarte self-assigned this Jul 16, 2021

carlosapaduarte added 2 commits July 16, 2021 20:27

Create play-button.md

7d3d563

update expectation

247d607

carlosapaduarte requested a review from Jym77 July 16, 2021 19:28

comments about the passed example

747fce7

Jym77 previously requested changes Jul 22, 2021

View reviewed changes

carlosapaduarte added 2 commits September 6, 2021 19:54

Add passed example with live audio from microphone on device

029a4a6

Update expectation

712fc60

Addresses https://github.com/act-rules/act-rules.github.io/pull/1661/files#r674724648

carlosapaduarte requested a review from Jym77 September 6, 2021 18:56

Jym77 requested changes Sep 9, 2021

View reviewed changes

Jym77 mentioned this pull request Sep 9, 2021

Definition of test instructions #1679

Draft

WilcoFiers mentioned this pull request Sep 21, 2021

Define "play button" in audio element content has text alternative [e7aa44] #1346

Closed

carlosapaduarte added 3 commits January 26, 2022 18:56

Merge branch 'develop' into live-media-resource

122254b

update description and content of PE1 to include instructions

04f15fa

Update spelling-ignore.yml

b8421b8

carlosapaduarte added 2 commits January 26, 2022 19:48

update expectation and PE1 to handle MediaStream not being seekable

2d300b5

Update spelling-ignore.yml

cee32c0

carlosapaduarte removed the Rule Use this label for a new rule that does not exist already label Feb 28, 2022

carlosapaduarte force-pushed the live-media-resource branch from d797a31 to cee32c0 Compare September 15, 2023 12:28

carlosapaduarte added 3 commits September 15, 2023 14:43

Update spelling-ignore.yml

bf23852

Fix conflicts

42031c6

Update audio-text-alternative-e7aa44.md

7865622

daniel-montalvo reviewed Sep 18, 2023

View reviewed changes

HelenBurge removed the reviewers wanted label May 29, 2025


		## Expectation

		The target element's [media resource](https://html.spec.whatwg.org/multipage/media.html#media-resource) is being broadcasted in real time without being first recorded and stored on the origin server.


		## Background

		- [Understanding SC 1.2.1:Audio-only and Video-only (Prerecorded)](https://www.w3.org/WAI/WCAG21/Understanding/audio-only-and-video-only-prerecorded)


		#### Passed Example 1

		This `audio` element plays a live media resource.


		This `audio` element plays a live media resource by streaming the audio from the device's microphone.

		This example requires a browser supporting the experimental MediaStreamTrack API. The browser must be authorized to access a microphone. You can successfully test this example on Google Chrome with the flag --enable-blink-features=WebCodecs,MediaStreamInsertableStreams

Replacing non-streaming audio with live audio #1661

Are you sure you want to change the base?

Replacing non-streaming audio with live audio #1661

Uh oh!

Conversation

carlosapaduarte commented Jun 25, 2021

How to Review And Approve

Uh oh!

ajanec01 commented Jun 29, 2021

Uh oh!

carlosapaduarte commented Jun 29, 2021

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

carlosapaduarte commented Sep 6, 2021

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!