Re: [Hls-interest] Use of characteristic tags for Subtitles in HLS streaming

Eryk Vershen <evershen@apple.com> Fri, 23 July 2021 16:27 UTC

Return-Path: <evershen@apple.com>
X-Original-To: hls-interest@ietfa.amsl.com
Delivered-To: hls-interest@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id E9BE83A0A2D for <hls-interest@ietfa.amsl.com>; Fri, 23 Jul 2021 09:27:12 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.451
X-Spam-Level:
X-Spam-Status: No, score=-2.451 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.452, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, HTML_MESSAGE=0.001, HTTPS_HTTP_MISMATCH=0.1, RCVD_IN_DNSWL_BLOCKED=0.001, RCVD_IN_MSPIKE_H2=-0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=unavailable autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=apple.com
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id M5M9xh0p2BjG for <hls-interest@ietfa.amsl.com>; Fri, 23 Jul 2021 09:27:08 -0700 (PDT)
Received: from ma1-aaemail-dr-lapp03.apple.com (ma1-aaemail-dr-lapp03.apple.com [17.171.2.72]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id BB4BA3A09FF for <hls-interest@ietf.org>; Fri, 23 Jul 2021 09:27:08 -0700 (PDT)
Received: from pps.filterd (ma1-aaemail-dr-lapp03.apple.com [127.0.0.1]) by ma1-aaemail-dr-lapp03.apple.com (8.16.0.42/8.16.0.42) with SMTP id 16NGHwbU004254; Fri, 23 Jul 2021 09:27:02 -0700
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=apple.com; h=from : message-id : content-type : mime-version : subject : date : in-reply-to : cc : to : references; s=20180706; bh=GfmQigsdXKPn+N2VDW08ANtnh2vOU4N4hbyADQB0Mz0=; b=r5RapwjYrjdkLcrqPq7lG8Rn9P+mioi5h3Vr+FU4zUZamnhzKp+HMloxg/M7pvCXuqCk jbaOjHpbuWR5ym0gOiT2aUrstUJsa1R4xOptpWpMVhgb2WxT9/32T849zPYflx1qewjP kTKvmaWKlo0qxocvU0ktv8KMEdBwyF+JZjRDOMM7026hKlHqSmXUmchMxlgztTQ6euS/ VQK/o1EKkwc970DedzoVz8mz0BRtjqUU0+qlrWcnj1R30bLR7L5Ndc+11ijGY295wCST hjZ8qFWKEr8LnSI0l2lb7sfHF81Male6GdECtVbtqFkhbzyaqmprYyAxmQwrF+fOfCpR tA==
Received: from rn-mailsvcp-mta-lapp01.rno.apple.com (rn-mailsvcp-mta-lapp01.rno.apple.com [10.225.203.149]) by ma1-aaemail-dr-lapp03.apple.com with ESMTP id 39vf0463sn-4 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128 verify=NO); Fri, 23 Jul 2021 09:27:02 -0700
Received: from rn-mailsvcp-mmp-lapp04.rno.apple.com (rn-mailsvcp-mmp-lapp04.rno.apple.com [17.179.253.17]) by rn-mailsvcp-mta-lapp01.rno.apple.com (Oracle Communications Messaging Server 8.1.0.9.20210415 64bit (built Apr 15 2021)) with ESMTPS id <0QWP00KGJHP2HY60@rn-mailsvcp-mta-lapp01.rno.apple.com>; Fri, 23 Jul 2021 09:27:02 -0700 (PDT)
Received: from process_milters-daemon.rn-mailsvcp-mmp-lapp04.rno.apple.com by rn-mailsvcp-mmp-lapp04.rno.apple.com (Oracle Communications Messaging Server 8.1.0.9.20210415 64bit (built Apr 15 2021)) id <0QWP00E00HBAGV00@rn-mailsvcp-mmp-lapp04.rno.apple.com>; Fri, 23 Jul 2021 09:27:02 -0700 (PDT)
X-Va-A:
X-Va-T-CD: 81ca60fce39c2560b6c4a7e5841f9b8f
X-Va-E-CD: 3c1d9f3232e08ca30872c80972b14e9b
X-Va-R-CD: 5a6f4c78666a4e33a78a95bbf83a9875
X-Va-CD: 0
X-Va-ID: d129bd2e-85f7-404f-bea0-4ace714120de
X-V-A:
X-V-T-CD: 81ca60fce39c2560b6c4a7e5841f9b8f
X-V-E-CD: 3c1d9f3232e08ca30872c80972b14e9b
X-V-R-CD: 5a6f4c78666a4e33a78a95bbf83a9875
X-V-CD: 0
X-V-ID: e25ef17c-cb8f-444a-ab3c-9bc176c921a7
X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:6.0.391, 18.0.790 definitions=2021-07-23_08:2021-07-23, 2021-07-23 signatures=0
Received: from smtpclient.apple ([17.11.11.203]) by rn-mailsvcp-mmp-lapp04.rno.apple.com (Oracle Communications Messaging Server 8.1.0.9.20210415 64bit (built Apr 15 2021)) with ESMTPSA id <0QWP00KBGHP15I00@rn-mailsvcp-mmp-lapp04.rno.apple.com>; Fri, 23 Jul 2021 09:27:02 -0700 (PDT)
From: Eryk Vershen <evershen@apple.com>
Message-id: <E179F535-18A7-4388-B601-4EAF4CD43377@apple.com>
Content-type: multipart/alternative; boundary="Apple-Mail=_7A226E20-26D6-4502-AB37-2285155F7512"
MIME-version: 1.0 (Mac OS X Mail 14.0 \(3654.100.0.2.22\))
Date: Fri, 23 Jul 2021 09:27:00 -0700
In-reply-to: <5B26C936-A7EC-4DB4-BF02-C26C9F3A7AC2@disneystreaming.com>
Cc: Eryk Vershen <evershen=40apple.com@dmarc.ietf.org>, James Hart <jwhart76@gmail.com>, "hls-interest@ietf.org" <hls-interest@ietf.org>
To: "May, Bill" <Bill.May=40disneystreaming.com@dmarc.ietf.org>
References: <CACwHNnMk3NCJ7jHcCJTMUBqWS5_bCZPqBYepa9XeDoMjGNSbGg@mail.gmail.com> <D0659BDD-A2DC-4DAA-86FB-890D3FC53BE0@apple.com> <5B26C936-A7EC-4DB4-BF02-C26C9F3A7AC2@disneystreaming.com>
X-Mailer: Apple Mail (2.3654.100.0.2.22)
X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:6.0.391, 18.0.790 definitions=2021-07-23_09:2021-07-23, 2021-07-23 signatures=0
Archived-At: <https://mailarchive.ietf.org/arch/msg/hls-interest/wXE1dtQwp_WMYW13ZLy8oASsWiw>
Subject: Re: [Hls-interest] Use of characteristic tags for Subtitles in HLS streaming
X-BeenThere: hls-interest@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "Discussions about HTTP Live Streaming \(HLS\)." <hls-interest.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/hls-interest>, <mailto:hls-interest-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/hls-interest/>
List-Post: <mailto:hls-interest@ietf.org>
List-Help: <mailto:hls-interest-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/hls-interest>, <mailto:hls-interest-request@ietf.org?subject=subscribe>
X-List-Received-Date: Fri, 23 Jul 2021 16:27:20 -0000

I believe the effect of the setting is to "prefer closed captions and SDH". That is, ordinary subtitles will be used if that is all that is available.
However, this will cause closed captions to be preferred over ordinary subtitles.

One of my co-workers pointed out that I should have referenced AVMediaFormat.h in addition to the documentation.

The discussion in AVMediaFormat.h for AVMediaCharacteristicTranscribesSpokenDialogForAccessibility (i.e., "public.accessibility.transcribes-spoken-dialog") states that you should not use the characteristic unless it "identifies speakers whenever other visual cues are insufficient for a viewer to determine who is speaking".

-eryk


> On Jul 23, 2021, at 8:38 AM, May, Bill <Bill.May=40disneystreaming.com@dmarc.ietf.org> wrote:
> 
> Eryk, 
> 
> Are the characteristics required for automatically selecting when accessibility settings request SDH?
> 
> We have some subtitles that are like English (without any characteristics), and some English[CC] (with transcribes-spoken-dialog and describes-music-and-sound).
> 
> If there are no characteristics, are the subtitles automatically selected with the accessibility settings are set?
> 
> Thanks, 
> Bill
> 
>> On Jul 23, 2021, at 8:31 AM, Eryk Vershen <evershen=40apple.com@dmarc.ietf.org <mailto:evershen=40apple.com@dmarc.ietf.org>> wrote:
>> 
>> Thanks for your inquiry.
>> 
>> I can see how the Authoring Specification rule 4.5 might cause confusion. The intent of the rule is that "public.accessibility.describes-music-and-sound" should be used in addition to "public.accessibility.transcribes-spoken-dialog". I'll make sure the rule is revised to be clearer.
>> 
>> The three characteristics relevant to subtitle renditions are (as draft-pantos-hls-rfc8216bis-09 says):
>> "public.accessibility.transcribes-spoken-dialog"
>> "public.accessibility.describes-music-and-sound"
>> "public.easy-to-read"
>> 
>> Characteristics are also known as AVMediaCharacteristics (see https://developer.apple.com/documentation/avfoundation/avmediacharacteristic <https://nam12.safelinks.protection.outlook.com/?url=https%3A%2F%2Fdeveloper.apple.com%2Fdocumentation%2Favfoundation%2Favmediacharacteristic&data=04%7C01%7Cbill.may%40disneystreaming.com%7C556ae618d588410189b508d94deefe56%7C65f03ca86d0a493e9e4ac85ac9526a03%7C1%7C0%7C637626511138327352%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=sKB6vwlkvOKi0wwAY3wyAMv2bv4iUgpcaLgvsZgSdGk%3D&reserved=0>).
>> 
>> A subtitle rendition may have none of these. For example, if only portions of the dialog are subtitled.
>> If the rendition is subtitled throughout, it should be marked "public.accessibility.transcribes-spoken-dialog".
>> If, in addition, the rendition has sound effects & music described, then it should also be marked "public.accessibility.describes-music-and-sound"
>> 
>> The last characteristic ("public.easy-to-read") is defined in the AVFoundation documentation above (AVMediaCharacteristicEasyToRead) as "'easy reader' captions (per the CEA-608 specification)".
>> 
>> regards,
>> -eryk
>> 
>>> On Jul 22, 2021, at 8:44 AM, James Hart <jwhart76@gmail.com <mailto:jwhart76@gmail.com>> wrote:
>>> 
>>> Hello,
>>> 
>>> I am trying to determine the correct use of the characteristics tags for subtitles in HTTP LIve Streaming and i am a little confused by the various sources of information and hoping some clarifications can be provided on what devices require:
>>> 
>>> From RFC-8216-09 <https://nam12.safelinks.protection.outlook.com/?url=https%3A%2F%2Fdatatracker.ietf.org%2Fdoc%2Fhtml%2Fdraft-pantos-hls-rfc8216bis-09%23section-4.4.6.1&data=04%7C01%7Cbill.may%40disneystreaming.com%7C556ae618d588410189b508d94deefe56%7C65f03ca86d0a493e9e4ac85ac9526a03%7C1%7C0%7C637626511138337307%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=WhHvxmLUoNnVDUq3H8k2YMtQloaBSpOKQ%2BzJ7YllLYU%3D&reserved=0> i see:
>>> 
>>> A SUBTITLES Rendition MAY include the following characteristics:
>>> "public.accessibility.transcribes-spoken-dialog", public.accessibility.describes-music-and-sound", and
>>> "public.easy-to-read" (which indicates that the subtitles have been edited for ease of reading).
>>> 
>>> From the HLS Authoring Specification <https://nam12.safelinks.protection.outlook.com/?url=https%3A%2F%2Fdeveloper.apple.com%2Fdocumentation%2Fhttp_live_streaming%2Fhls_authoring_specification_for_apple_devices&data=04%7C01%7Cbill.may%40disneystreaming.com%7C556ae618d588410189b508d94deefe56%7C65f03ca86d0a493e9e4ac85ac9526a03%7C1%7C0%7C637626511138337307%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=rlXRj3C9WPJ0FVi62yALi8gWk%2BBfYP%2Fuk1L07olHoOs%3D&reserved=0> for Apple Devices i see only one characteristic defined:
>>> 
>>> 4.5. If a subtitles track is intended to provide accessibility for people who are deaf or hard of hearing, it MUST be marked with the attribute CHARACTERISTICS="public.accessibility.describes-music-and-sound". (Subtitles with this attribute value are treated the same as closed captions.)
>>> 
>>> Then if i compare this with the sample streams on the Developer Site <https://nam12.safelinks.protection.outlook.com/?url=https%3A%2F%2Fdeveloper.apple.com%2Fstreaming%2Fexamples%2F&data=04%7C01%7Cbill.may%40disneystreaming.com%7C556ae618d588410189b508d94deefe56%7C65f03ca86d0a493e9e4ac85ac9526a03%7C1%7C0%7C637626511138347260%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=MPSaRKDfy1NMENPtttujtqOSVzQuMR2s3aYAQo5Le0w%3D&reserved=0> i can see one such example contains subtitles  <https://nam12.safelinks.protection.outlook.com/?url=https%3A%2F%2Fdeveloper.apple.com%2Fstreaming%2Fexamples%2Fbasic-stream-osx-ios5.html&data=04%7C01%7Cbill.may%40disneystreaming.com%7C556ae618d588410189b508d94deefe56%7C65f03ca86d0a493e9e4ac85ac9526a03%7C1%7C0%7C637626511138347260%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=ZqYNWBUK7gRD6dgTTljbZrFd5Z69j7xGbrmJrqguA8w%3D&reserved=0>with the characteristics "public.accessibility.transcribes-spoken-dialog, public.accessibility.describes-music-and-sound" within the top level m3u8, which does not appear aligned fully with the HLS authoring specification.  For reference this was the example i used:
>>> 
>>> $ curl 'https://devstreaming-cdn.apple.com/videos/streaming/examples/bipbop_16x9/bipbop_16x9_variant.m3u8 <https://nam12.safelinks.protection.outlook.com/?url=https%3A%2F%2Fdevstreaming-cdn.apple.com%2Fvideos%2Fstreaming%2Fexamples%2Fbipbop_16x9%2Fbipbop_16x9_variant.m3u8&data=04%7C01%7Cbill.may%40disneystreaming.com%7C556ae618d588410189b508d94deefe56%7C65f03ca86d0a493e9e4ac85ac9526a03%7C1%7C0%7C637626511138347260%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=UWi64zEVPZZcG7Mmj4P31D99qUTL0UX7EmYBlsK03yE%3D&reserved=0>'
>>> #EXTM3U
>>>  
>>> #EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="bipbop_audio",LANGUAGE="eng",NAME="BipBop Audio 1",AUTOSELECT=YES,DEFAULT=YES
>>> #EXT-X-MEDIA:TYPE=AUDIO,GROUP-ID="bipbop_audio",LANGUAGE="eng",NAME="BipBop Audio 2",AUTOSELECT=NO,DEFAULT=NO,URI="alternate_audio_aac/prog_index.m3u8"
>>>  
>>>  
>>> #EXT-X-MEDIA:TYPE=SUBTITLES,GROUP-ID="subs",NAME="English",DEFAULT=YES,AUTOSELECT=YES,FORCED=NO,LANGUAGE="en",CHARACTERISTICS="public.accessibility.transcribes-spoken-dialog, public.accessibility.describes-music-and-sound",URI="subtitles/eng/prog_index.m3u8"
>>> < - - snip - - >
>>> 
>>> 
>>> Appreciate some pointers on the correct signaling here.
>>> 
>>> Many thanks,
>>> 
>>> James Hart 
>>> -- 
>>> Hls-interest mailing list
>>> Hls-interest@ietf.org <mailto:Hls-interest@ietf.org>
>>> https://www.ietf.org/mailman/listinfo/hls-interest <https://www.ietf.org/mailman/listinfo/hls-interest>
>> 
>> -- 
>> Hls-interest mailing list
>> Hls-interest@ietf.org <mailto:Hls-interest@ietf.org>
>> https://www.ietf.org/mailman/listinfo/hls-interest
> 
> -- 
> Hls-interest mailing list
> Hls-interest@ietf.org
> https://www.ietf.org/mailman/listinfo/hls-interest