diff --git a/__tests__/spelling-ignore.yml b/__tests__/spelling-ignore.yml index 5bcd525eea8..b49936cc349 100755 --- a/__tests__/spelling-ignore.yml +++ b/__tests__/spelling-ignore.yml @@ -83,6 +83,10 @@ - iso # lowercase needed in reference list - RFC - rfc +- MediaStream +- MediaStreamTrack +- enable-blink-features=WebCodecs +- MediaStreamInsertableStreams # spell checker checks against strict casing & hence some repeated words here - Autocomplete @@ -220,10 +224,12 @@ - unicity - Menuitem - menuitems +- broadcasted - namespaced-element - Namespaced - namespaceURI - testability +- seekable # Parts of Unicode - 000A diff --git a/_rules/audio-as-media-alternative-afb423.md b/_rules/audio-as-media-alternative-afb423.md index fb7be50f3c6..41d994edcbb 100755 --- a/_rules/audio-as-media-alternative-afb423.md +++ b/_rules/audio-as-media-alternative-afb423.md @@ -20,7 +20,7 @@ acknowledgments: ## Applicability -This rule applies to every [non-streaming](#non-streaming-media-element) `audio` element that is: +This rule applies to every `audio` element that is: - playing; or, - has a "play button" that is [visible][] and [included in the accessibility tree][]. diff --git a/_rules/audio-is-live-213x3x.md b/_rules/audio-is-live-213x3x.md new file mode 100755 index 00000000000..e2af83e6abc --- /dev/null +++ b/_rules/audio-is-live-213x3x.md @@ -0,0 +1,140 @@ +--- +id: 213x3x +name: '`audio` element plays live content' +rule_type: atomic +description: | + This rule checks the content played by an `audio` element is live +accessibility_requirements: +input_aspects: + - DOM Tree + - CSS Styling + - Audio output +acknowledgments: + authors: + - Carlos Duarte +--- + +## Applicability + +This rule applies to every `audio` element that is: + +- playing; or, +- has a [play button][] that is [visible][] and [included in the accessibility tree][]. + +## Expectation + +For each test target at least one of the following is true: + +- the target element's [media resource][] is not [seekable][]; or +- after [seeking][seek] the end of the target element's [media resource][] the [current playback position][] is not the end of the target element's [media resource][]. + +## Assumptions + +_No assumptions._ + +## Accessibility Support + +There are no major accessibility support issues known for this rule. + +## 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) + +## Test Cases + +### Passed + +#### Passed Example 1 + +This `audio` element plays a live media resource by streaming the audio from the device's microphone. The [media resource][] is a MediaStream which is not [seekable][]. + +Test instructions: + +- Load the test case in a browser supporting the experimental MediaStreamTrack API (You can successfully test this example on Google Chrome with the flag --enable-blink-features=WebCodecs,MediaStreamInsertableStreams); +- Authorize the browser to access a microphone. + +```html + +

+ 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 +

+ +

+ + + + +``` + +### Failed + +#### Failed Example 1 + +This `audio` element plays a recorded media resource. + +```html + + + +``` + +### Inapplicable + +#### Inapplicable Example 1 + +This `audio` element's controls are not [visible][] on the page. + +```html + + + +``` + +#### Inapplicable Example 2 + +This `audio` element does not have controls. + +```html + + + +``` + +[current playback position]: https://html.spec.whatwg.org/multipage/media.html#current-playback-position +[included in the accessibility tree]: #included-in-the-accessibility-tree 'Definition of included in the accessibility tree' +[media resource]: https://html.spec.whatwg.org/multipage/media.html#media-resource +[play button]: #play-button +[seek]: https://html.spec.whatwg.org/multipage/media.html#dom-media-seek +[seekable]: https://html.spec.whatwg.org/multipage/media.html#dom-media-seekable +[visible]: #visible 'Definition of visible' diff --git a/_rules/audio-text-alternative-e7aa44.md b/_rules/audio-text-alternative-e7aa44.md index 254e6af0983..9156e45de72 100755 --- a/_rules/audio-text-alternative-e7aa44.md +++ b/_rules/audio-text-alternative-e7aa44.md @@ -18,6 +18,7 @@ accessibility_requirements: input_rules: - 2eb176 - afb423 + - 213x3x acknowledgments: authors: - Brian Bors @@ -30,7 +31,7 @@ acknowledgments: ## Applicability -This rule applies to any [non-streaming](#non-streaming-media-element) `audio` element that is: +This rule applies to any `audio` element that is: - playing; or, - has a "play button" that is [visible][] and [included in the accessibility tree](#included-in-the-accessibility-tree). @@ -43,6 +44,7 @@ For each test target, the [outcome](#outcome) of at least one of the following r - [`Audio` Element Content Has Transcript](https://act-rules.github.io/rules/2eb176) - [`Audio` Element Content Is Media Alternative For Text](https://act-rules.github.io/rules/afb423) +- [`Audio` Element Plays Live Content](https://act-rules.github.io/rules/213x3x) ## Assumptions diff --git a/_rules/audio-transcript-2eb176.md b/_rules/audio-transcript-2eb176.md index 907181775cd..3d1cdba3724 100755 --- a/_rules/audio-transcript-2eb176.md +++ b/_rules/audio-transcript-2eb176.md @@ -20,7 +20,7 @@ acknowledgments: ## Applicability -This rule applies to every [non-streaming](#non-streaming-media-element) `audio` element that is: +This rule applies to every `audio` element that is: - playing; or, - has a "play button" that is [visible][] and [included in the accessibility tree][]. diff --git a/pages/glossary/play-button.md b/pages/glossary/play-button.md new file mode 100755 index 00000000000..262fbb1b805 --- /dev/null +++ b/pages/glossary/play-button.md @@ -0,0 +1,12 @@ +--- +title: Play button +key: play-button +unambiguous: true +objective: false +--- + +A play button is an [instrument][] that when [activated][] plays a [media resource][]. + +[activated]: https://html.spec.whatwg.org/#activation +[instrument]: #instrument-to-achieve-an-objective +[media resource]: https://html.spec.whatwg.org/multipage/media.html#media-resource