Add i18n-related informative notes about locale passing between devices #100
Conversation
As discussed in w3c#66, the first note encourages the user agent to render user friendly names for the remote playback device, using its locale and text direction; the second note encourages the user agent to pass locale information to the remote playback device so that it may adjust its behavior accordingly.
index.html
Outdated
| functions to locale-specific attributes that reflect the user's | ||
| preferences. | ||
| </div> | ||
| <div class="note"> | ||
| The user agent SHOULD pause local audio and video output of the |
There was a problem hiding this comment.
"The user agent is expected to pause"
|
One minor change from "SHOULD" to "is expected to" in a note, otherwise this looks great. Thanks! |
|
(Please omit #100 (comment), since that note is being dropped in #102.) |
index.html
Outdated
| permission</em>). | ||
| permission</em>). The user agent is encouraged to render user | ||
| friendly names of available devices, using their locale and text | ||
| direction when they are known. |
There was a problem hiding this comment.
The Presentation API text is more specific, suggesting that the locale and text direction originate from the remote playback device (not necessarily the preferences of the user agent displaying the name).
https://w3c.github.io/presentation-api/#selecting-a-presentation-display
There was a problem hiding this comment.
OK, I've slightly updated the text to clarify the message (for once, we cannot encourage the user agent to render "user friendly names" without clarifying that we're not expecting the user agent to invent user friendly names but rather to use the ones it has discovered).
index.html
Outdated
| @@ -1177,6 +1179,13 @@ | |||
| sync (unless <a>media mirroring</a> is used). | |||
| </div> | |||
| <div class="note"> | |||
| The user agent is encouraged to pass locale information to the | |||
There was a problem hiding this comment.
Nit: "locale and text direction information"? Usually the latter is implied by the former, but text direction is called out in the other note.
index.html
Outdated
| @@ -1177,6 +1179,13 @@ | |||
| sync (unless <a>media mirroring</a> is used). | |||
| </div> | |||
| <div class="note"> | |||
| The user agent is encouraged to pass locale information to the | |||
| <a>remote playback device</a> when possible, so that the <a>remote | |||
| playback device</a> may adjust its user interface and operational | |||
There was a problem hiding this comment.
It might be worth describing how this interacts with default text track selection. For example the remote playback device should choose the same default text track as the controlling user agent (given that user agent's locale preferences are sent from the latter to the former). Perhaps this is implied by your comment already though.
There was a problem hiding this comment.
It was meant to be implied, but it seems worth calling out one or two examples of why that information is useful for remote playback devices. I added a sentence of default text track selection, and a note on the HTTP Accept-Language header.
index.html
Outdated
| <a>remote playback device</a> when possible, so that the <a>remote | ||
| playback device</a> may adjust its user interface and operational | ||
| functions to locale-specific attributes that reflect the user's | ||
| preferences. |
There was a problem hiding this comment.
The Presentation API specifically asks the presentation receiver to set HTTP headers consistent with the controlling user agent's locale.
https://w3c.github.io/presentation-api/#creating-a-receiving-browsing-context
For remote playback, these headers could impact which media resource is fetched by the remote playback device (in the flinging case), if different media resources have locale-specific embedded text cues.
There was a problem hiding this comment.
See previous comment, I included this as an example of locale usage by the remote playback device.
As discussed in #66, the first note encourages the user agent to render user friendly names for the remote playback device, using its locale and text direction; the second note encourages the user agent to pass locale information to the remote playback device so that it may adjust its behavior accordingly.
Preview | Diff