From 1ad17324858f57c75836040c02b06deadcd3ada2 Mon Sep 17 00:00:00 2001 From: Will Law Date: Wed, 24 Jul 2024 14:33:03 +0200 Subject: [PATCH 1/3] Update draft-ietf-moq-catalogformat.md --- draft-ietf-moq-catalogformat.md | 37 ++++++++++++++------------------- 1 file changed, 16 insertions(+), 21 deletions(-) diff --git a/draft-ietf-moq-catalogformat.md b/draft-ietf-moq-catalogformat.md index 7479a8e..d3aa13c 100644 --- a/draft-ietf-moq-catalogformat.md +++ b/draft-ietf-moq-catalogformat.md @@ -137,7 +137,7 @@ Table 1 provides an overview of all fields defined by this document. | Catalogs | catalogs | {{catalogs}} | | Track namespace | namespace | {{tracknamespace}} | | Track name | name | {{trackname}} | -| Packaging | packaging | {{packaging}} | +| Format | format | {{format}} | | Track label | label | {{tracklabel}} | | Render group | renderGroup | {{rendergroup}} | | Alternate group | altGroup | {{altgroup}} | @@ -249,18 +249,13 @@ Location: TFC Required: Yes Json Type: String A string defining the name of the track. See section 2.3 of {{MoQTransport}}. Within the catalog, track names MUST be unique per namespace. -### Packaging {#packaging} +### Format {#format} Location: TF Required: Yes Json Type: String -A string defining the type of payload encapsulation. Allowed values are strings -as defined in Table 3. - -Table 3: Allowed packaging values - -| Name | Value | Draft | -|:================|:==========|:=================| -| CMAF | "cmaf" | See [CMAF] | -| LOC | "loc" | See RFC XXXX | +A string defining the format of the track. Format may describe the packaging, +serialization or encapsulation of the track contents. The allowed values +of this field are defined by the application format utilizing this catalog +specification. ### Track label {#tracklabel} Location: TF Required: Optional Json Type: String @@ -446,7 +441,7 @@ time-aligned audio and video tracks. "streamingFormatVersion": "0.2", "commonTrackFields": { "namespace": "conference.example.com/conference123/alice", - "packaging": "loc", + "format": "loc", "renderGroup": 1 }, "tracks": [ @@ -485,7 +480,7 @@ supportsDeltaUpdates flag. "supportsDeltaUpdates": true, "commonTrackFields": { "renderGroup": 1, - "packaging": "loc" + "format": "loc" }, "tracks":[ { @@ -559,7 +554,7 @@ express the track relationships. "commonTrackFields": { "namespace": "conference.example.com/conference123/alice", "renderGroup": 1, - "packaging": "loc" + "format": "loc" }, "tracks":[ { @@ -661,7 +656,7 @@ tracks. "supportsDeltaUpdates": true, "commonTrackFields": { "namespace": "sports.example.com/games/08-08-23/12345", - "packaging": "cmaf", + "format": "cmaf", "renderGroup":1 }, "tracks": [ @@ -724,13 +719,13 @@ LOC packaged audio. "selectionParams":{"codec":"avc1.64001f","mimeType":"video/mp4", "width":1280,"height":720,"framerate":30,"bitrate":4952892}, "initTrack":"init_video_720", - "packaging":"cmaf" + "format":"cmaf" }, { "name": "audio", "selectionParams":{"codec":"opus","samplerate":48000,"channelConfig":"2", "bitrate":32000}, - "packaging": "loc" + "format": "loc" } ] } @@ -750,7 +745,7 @@ The data has been truncated for clarity. "streamingFormatVersion": "0.2", "commonTrackFields": { "namespace": "sports.example.com/games/08-08-23/12345", - "packaging": "cmaf", + "format": "cmaf", "renderGroup":1 }, "tracks": [ @@ -783,7 +778,7 @@ description. "streamingFormatVersion": "0.2", "commonTrackFields": { "namespace": "conference.example.com/conference123/alice", - "packaging": "loc", + "format": "loc", "renderGroup": 1 }, "tracks": [ @@ -921,8 +916,8 @@ Location: TC
JSON Type: String
Specification: [MoQCatalog]
-Descriptive Name: Packaging
-Field Name: packaging
+Descriptive Name: Format
+Field Name: format
Required: yes
Location: RT
JSON Type: String
From d7a3c0cab555471e39ebd498134fc3fddba17231 Mon Sep 17 00:00:00 2001 From: Will Law Date: Wed, 24 Jul 2024 14:55:26 +0200 Subject: [PATCH 2/3] Update draft-ietf-moq-catalogformat.md Adding a new example. --- draft-ietf-moq-catalogformat.md | 57 +++++++++++++++++++++++++++++++-- 1 file changed, 55 insertions(+), 2 deletions(-) diff --git a/draft-ietf-moq-catalogformat.md b/draft-ietf-moq-catalogformat.md index d3aa13c..e66b1a5 100644 --- a/draft-ietf-moq-catalogformat.md +++ b/draft-ietf-moq-catalogformat.md @@ -137,7 +137,7 @@ Table 1 provides an overview of all fields defined by this document. | Catalogs | catalogs | {{catalogs}} | | Track namespace | namespace | {{tracknamespace}} | | Track name | name | {{trackname}} | -| Format | format | {{format}} | +| Track format | format | {{format}} | | Track label | label | {{tracklabel}} | | Render group | renderGroup | {{rendergroup}} | | Alternate group | altGroup | {{altgroup}} | @@ -249,7 +249,7 @@ Location: TFC Required: Yes Json Type: String A string defining the name of the track. See section 2.3 of {{MoQTransport}}. Within the catalog, track names MUST be unique per namespace. -### Format {#format} +### Track format {#format} Location: TF Required: Yes Json Type: String A string defining the format of the track. Format may describe the packaging, @@ -731,6 +731,59 @@ LOC packaged audio. } ~~~ +### Multi-track-format example + +This example shows catalog describing a broadcast with many +different track formats. The format values are defined by the +application specification which is referencing this catalog +specification. + +~~~json +{ + "version": 1, + "streamingFormat": 1, + "streamingFormatVersion": "0.2", + "commonTrackFields": { + "namespace": "output.example.com/event/12345" + }, + "tracks":[ + { + "name": "game-instructions", + "type": "datachannel", + "format": "CBOR-special" + }, + { + "name": "media-timeline", + "type": "timeline", + "format": "csv" + }, + { + "name": "hd", + "selectionParams": {"codec":"av01","width":1920,"height":1080, + "bitrate":5000000,"framerate":30}, + "altGroup":1, + "renderGroup":1, + "format": "cmaf" + }, + { + "name": "sd", + "selectionParams": {"codec":"av01","width":192,"height":144, + "bitrate":500000,"framerate":30}, + "altGroup":1, + "renderGroup":1, + "format": "cmaf" + }, + { + "name": "audio", + "selectionParams":{"codec":"opus","samplerate":48000,"channelConfig":"2", + "bitrate":32000}, + "renderGroup":1, + "format": "loc" + } + ] +} +~~~ + ### CMAF Tracks with inband init segments From 28ea58b8fe968e320f4156d87f14f744774f6ca2 Mon Sep 17 00:00:00 2001 From: Will Law Date: Wed, 24 Jul 2024 14:58:17 +0200 Subject: [PATCH 3/3] Update draft-ietf-moq-catalogformat.md --- draft-ietf-moq-catalogformat.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/draft-ietf-moq-catalogformat.md b/draft-ietf-moq-catalogformat.md index e66b1a5..cd38cd5 100644 --- a/draft-ietf-moq-catalogformat.md +++ b/draft-ietf-moq-catalogformat.md @@ -734,7 +734,7 @@ LOC packaged audio. ### Multi-track-format example This example shows catalog describing a broadcast with many -different track formats. The format values are defined by the +different track formats. The format values are defined by the application specification which is referencing this catalog specification.