Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 24 additions & 24 deletions draft-ietf-moq-warp.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: "WARP Streaming Format"
title: "MOQT Streaming Format"
category: info

docname: draft-ietf-moq-warp-latest
Expand All @@ -13,7 +13,7 @@ workgroup: "Media Over QUIC"
keyword:
- MoQ
- MoQTransport
- WARP
- MSF
venue:
group: "Media Over QUIC"
type: "Working Group"
Expand Down Expand Up @@ -73,22 +73,22 @@ informative:

--- abstract

This document specifies the WARP Streaming Format, designed to operate on Media Over QUIC Transport.
This document specifies the MOQT Streaming Format, designed to operate on Media Over QUIC Transport.


--- middle

# Introduction

WARP Streaming Format (WARP) is a media format designed to deliver LOC {{LOC}}
MOQT Streaming Format (MSF) is a media format designed to deliver LOC {{LOC}}
compliant media content over Media Over QUIC Transport (MOQT) {{MoQTransport}}.
WARP works by fragmenting the bitstream into objects that can be independently
transmitted. WARP leverages a catalog format to describe the output of the
original publisher. WARP specifies how content should be packaged and signaled,
MSF works by fragmenting the bitstream into objects that can be independently
transmitted. MSF leverages a catalog format to describe the output of the
original publisher. MSF specifies how content should be packaged and signaled,
defines how the catalog communicates the content, specifies prioritization
strategies for real-time and workflows for beginning and terminating broadcasts.
WARP also details how end-subscribers may perform adaptive bitrate switching.
WARP is targeted at real-time and interactive levels of live latency, as well as
MSF also details how end-subscribers may perform adaptive bitrate switching.
MSF is targeted at real-time and interactive levels of live latency, as well as
VOD content.

This document describes version 1 of the streaming format.
Expand All @@ -102,7 +102,7 @@ describing the binary encoding.

# Scope

The purpose of WARP is to provide an interoperable media streaming format
The purpose of MSF is to provide an interoperable media streaming format
operating over {{MoQTransport}}. Interoperability implies that:

* An original publisher can package incoming media content into tracks, prepare
Expand All @@ -114,7 +114,7 @@ operating over {{MoQTransport}}. Interoperability implies that:
* A final subscriber can parse the catalog, request tracks, decode and render
the received media data.

WARP is intended to provide a format for delivering commercial media content. To
MSF is intended to provide a format for delivering commercial media content. To
that end, the following features are within scope:

* Video codecs - all codecs supported by {{LOC}}
Expand All @@ -141,12 +141,12 @@ that end, the following features are within scope:
* Logs and analytics management - support for the reporting of client-side QoE
and relay delivery actions.

Initial verisons of WARP will prioritize basic features necessary to exercise
Initial verisons of MSF will prioritize basic features necessary to exercise
interoperability across delivery systems. Later versions will add commercially
necessary features.

# Media packaging {#mediapackaging}
WARP delivers LOC {{LOC}} packaged media bitstreams.
MSF delivers LOC {{LOC}} packaged media bitstreams.

## LOC packaging
This specification references Low Overhead Container (LOC) {{LOC}} to define how
Expand All @@ -159,15 +159,15 @@ When LOC packaging is used for a track, the catalog packaging attribute
({{packaging}}) MUST be present and it MUST be populated with a value of "loc".

## Time-alignment {#timealignment}
WARP Tracks MAY be time-aligned. Those that are, are subject to the following
MSF Tracks MAY be time-aligned. Those that are, are subject to the following
requirements:

* Tracks advertised in the catalog as belonging to a common render group MUST
be time-aligned.
* The render duration of the first media object of each equally numbered MOQT
Group, after decoding, MUST have overlapping presentation time.

A consequence of this restriction is that a WARP receiver SHOULD be able to
A consequence of this restriction is that an MSF receiver SHOULD be able to
cleanly switch between time-aligned media tracks at group boundaries.

## Content protection and encryption {#contentprotection}
Expand All @@ -176,7 +176,7 @@ ToDo - content protection for LOC-packaged content.

# Catalog {#catalog}
A Catalog is an MOQT Track that provides information about the other tracks being
produced by a WARP publisher. A Catalog is used by WARP publishers for
produced by a MSF publisher. A Catalog is used by MSF publishers for
advertising their output and for subscribers in consuming that output. The
payload of the Catalog object is opaque to Relays and can be end-to-end
encrypted. The Catalog provides the names and namespaces of the tracks being
Expand Down Expand Up @@ -207,7 +207,7 @@ Table 1 provides an overview of all fields defined by this document.

| Field | Name | Definition |
|:========================|:=======================|:==========================|
| WARP version | version | {{warpversion}} |
| MSF version | version | {{msfversion}} |
| Delta update | deltaUpdate | {{deltaupdate}} |
| Add tracks | addTracks | {{addtracks}} |
| Remove tracks | removeTracks | {{removetracks}} |
Expand Down Expand Up @@ -252,10 +252,10 @@ Table 2 defines the allowed locations for these fields within the document
| T | Track object |


### WARP version {#warpversion}
### MSF version {#msfversion}
Location: R Required: Yes JSON Type: Number

Specifies the version of WARP referenced by this catalog. There is no guarantee
Specifies the version of MSF referenced by this catalog. There is no guarantee
that future catalog versions are backwards compatible and field definitions and
interpretation may change between versions. A subscriber MUST NOT attempt to
parse a catalog version which it does not understand.
Expand Down Expand Up @@ -369,8 +369,8 @@ Table 4: Reserved track roles
| audiodescription | An audio description for visually impaired users |
| video | Visual content |
| audio | Audio content |
| mediatimeline | A WARP media timeline {{mediatimelinetrack}} |
| eventtimeline | A WARP event timeline {{eventtimelinetrack}} |
| mediatimeline | An MSF media timeline {{mediatimelinetrack}} |
| eventtimeline | An MSF event timeline {{eventtimelinetrack}} |
| caption | A textual representation of the audio track |
| subtitle | A transcription of the spoken dialogue |
| signlanguage | A visual track for hearing impaired users. |
Expand Down Expand Up @@ -550,7 +550,7 @@ The following rules are to be followed in constructing and processing delta upda
* A delta update catalog MUST contain at least one instance of Add tracks
{{addtracks}}, Remove tracks {{removetracks}} or Clone Tracks {{clonetracks}}
fields and MAY contain more. It MUST NOT contain an instance of a Tracks
{{tracks}} field or a WARP version {{warpversion}} field.
{{tracks}} field or an MSF version {{msfversion}} field.
* The Add, Delete and Clone operations are applied sequentially in the order they
are declared in the document. Each operation in the sequence is applied to the
target document; the resulting document becomes the target of the next operation.
Expand Down Expand Up @@ -1172,7 +1172,7 @@ This example shows drone GPS coordinates synched with the start of each Group.
# Workflow

## Initiating a broadcast
A WARP publisher MUST publish a catalog track object before publishing any media
An MSF publisher MUST publish a catalog track object before publishing any media
track objects.

## Ending a live broadcast
Expand All @@ -1197,7 +1197,7 @@ ToDo

This document creates a new entry in the "MoQ Streaming Format" Registry
(see {{MoQTransport}} Sect 8). The type value is 0x001, the name is
"WARP Streaming Format" and the RFC is XXX.
"MOQT Streaming Format" and the RFC is XXX.

--- back

Expand Down