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

Eryk Vershen <evershen@apple.com> Fri, 23 July 2021 15:31 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 DB1D73A10A4 for <hls-interest@ietfa.amsl.com>; Fri, 23 Jul 2021 08:31:46 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -4.852
X-Spam-Level:
X-Spam-Status: No, score=-4.852 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, RCVD_IN_DNSWL_MED=-2.3, RCVD_IN_MSPIKE_H2=-0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham 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 krpinGMSSuIf for <hls-interest@ietfa.amsl.com>; Fri, 23 Jul 2021 08:31:42 -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 7B2E23A10B1 for <hls-interest@ietf.org>; Fri, 23 Jul 2021 08:31:42 -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 16NFDtmf022710; Fri, 23 Jul 2021 08:31:40 -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=kNC8Bgm1ZsNTfC5qAX4drPB5pxQNOHip+SL84WEa6fg=; b=ShlvayusdSrBSRzchTiyf/4+nLIMGyJsggqi5DoQOHk8lJpRGUVFyaTSMhQwOqxcNYFy 5pFDn8cil0Btdp5wloWadPskkoojmZg53N4y1qqwHiGHccFMNhs9S03NFW+mi42BW+Qf RrTf2A4hPe+UCUhz1WIvoMK/7qsk1hTWaX7gQQgyYz0lMLsF3lDx08P9fbuoNDne5oge IP7kdv3+AVoX7eGIwR96wtnndfBiY+OxzGVmIJuUMpaWkQQZnYvshs4CsC/0LLlnCn+z Fh3VprZKXYxyWcNZUa5+t2W5fYYBl3Vj1kIOwMHW5nhUyZ1UpIQtzdiqVWEGsGGWNmhz /A==
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 39vf045g28-11 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128 verify=NO); Fri, 23 Jul 2021 08:31:40 -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 <0QWP00Q7QF4SJEF0@rn-mailsvcp-mta-lapp01.rno.apple.com>; Fri, 23 Jul 2021 08:31:40 -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 <0QWP00Y00EWWAU00@rn-mailsvcp-mmp-lapp04.rno.apple.com>; Fri, 23 Jul 2021 08:31:40 -0700 (PDT)
X-V-A:
X-V-T-CD: eb5be9405c2514c0eb92c7fc900c7df7
X-V-E-CD: 3c1d9f3232e08ca30872c80972b14e9b
X-V-R-CD: 5a6f4c78666a4e33a78a95bbf83a9875
X-V-CD: 0
X-V-ID: 1331687d-18f3-4621-9591-9f37cb9c7fbc
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 <0QWP00HO9F4M9H00@rn-mailsvcp-mmp-lapp04.rno.apple.com>; Fri, 23 Jul 2021 08:31:34 -0700 (PDT)
From: Eryk Vershen <evershen@apple.com>
Message-id: <D0659BDD-A2DC-4DAA-86FB-890D3FC53BE0@apple.com>
Content-type: multipart/alternative; boundary="Apple-Mail=_CD6205F6-B3C9-418A-A017-9DB2F7EE318C"
MIME-version: 1.0 (Mac OS X Mail 14.0 \(3654.100.0.2.22\))
Date: Fri, 23 Jul 2021 08:31:32 -0700
In-reply-to: <CACwHNnMk3NCJ7jHcCJTMUBqWS5_bCZPqBYepa9XeDoMjGNSbGg@mail.gmail.com>
Cc: hls-interest@ietf.org
To: James Hart <jwhart76@gmail.com>
References: <CACwHNnMk3NCJ7jHcCJTMUBqWS5_bCZPqBYepa9XeDoMjGNSbGg@mail.gmail.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_08:2021-07-23, 2021-07-23 signatures=0
Archived-At: <https://mailarchive.ietf.org/arch/msg/hls-interest/ppCjGe_4ePpMvkzJPPOQ3MKIVTE>
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 15:31:47 -0000

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://developer.apple.com/documentation/avfoundation/avmediacharacteristic>).

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> 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://datatracker.ietf.org/doc/html/draft-pantos-hls-rfc8216bis-09#section-4.4.6.1> 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://developer.apple.com/documentation/http_live_streaming/hls_authoring_specification_for_apple_devices> 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://developer.apple.com/streaming/examples/> i can see one such example contains subtitles  <https://developer.apple.com/streaming/examples/basic-stream-osx-ios5.html>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://devstreaming-cdn.apple.com/videos/streaming/examples/bipbop_16x9/bipbop_16x9_variant.m3u8>'
> #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
> https://www.ietf.org/mailman/listinfo/hls-interest