| Internet-Draft | MoQ Feedback | July 2026 |
| Liu, et al. | Expires 1 February 2027 | [Page] |
This document defines an extension to Media over QUIC Transport (MOQT) that enables MoQ receivers to report delivery quality information for media Objects to senders. The MoQ layer synthesizes MMF feedback and local congestion control (CC) output to compute control decisions such as bitrate, frame rate, and pacing, and inform the CC algorithm module via a cross-layer control interface. This mechanism reuses the MOQT Track/Object data model without introducing new control message types. While QUIC ACK and reception timestamp extensions continue to provide per-packet CC signals; this mechanism adds per-Object media semantic feedback when the MMF extension is negotiated and enabled.¶
This note is to be removed before publishing as an RFC.¶
Discussion of this document takes place on the Media Over QUIC Working Group mailing list (moq@ietf.org), which is archived at https://mailarchive.ietf.org/arch/browse/moq/.¶
Source for this draft and an issue tracker can be found at https://github.com/Yanmei-Liu/draft-moq-multimodal-feedback.¶
This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79.¶
Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet-Drafts is at https://datatracker.ietf.org/drafts/current/.¶
Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress."¶
This Internet-Draft will expire on 1 February 2027.¶
Copyright (c) 2026 IETF Trust and the persons identified as the document authors. All rights reserved.¶
This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Revised BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Revised BSD License.¶
Media over QUIC Transport (MOQT, [MoQTransport]) is a QUIC-based publish/subscribe media transport framework. In low-latency interactive scenarios, senders need to obtain media delivery quality information from peer to adjust sending strategies. Adjustments occur at two layers:¶
Application layer: Encoders adjust bitrate/frame rate, inference systems adjust generation rate, and ABR switches Tracks.¶
Transport layer: Congestion control (CC) algorithms adjust cwnd/pacing rate.¶
QUIC Transport layer feedback (QUIC-ACK, receive timestamps [quic-receive-ts]) only covers the transport layer, leaving blind spots at the MoQ semantic level (see Section 2 for details). This document defines a MoQ-layer feedback mechanism that provides per-Object media semantic feedback to the application layer. The MoQ layer also serves as the control layer for CC algorithms, synthesizing MMF signals and local transport state to issue control commands such as pacing rate and pacing gain to CC (see Section 3.3 for details).¶
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all capitals, as shown here.¶
The following terms are used throughout this document:¶
MOQT: Media over QUIC Transport, following [MoQTransport].¶
Object: The smallest semantic unit of data delivery in MOQT.¶
Relay: A MoQ node that forwards a media Track between its publisher and subscribers, following [MoQTransport].¶
Media Original Publisher: The Original Publisher, as defined by [MoQTransport], of the media Track associated with a Feedback Track.¶
Adjacent Media Publisher: The Publisher from which a Subscriber receives the associated media Track on a particular MOQT session. It can be a Relay or the Media Original Publisher.¶
Feedback Publisher: The Publisher of a Feedback Track, typically a Subscriber of the associated media Track.¶
Feedback Track: A MoQ Track that carries MMF feedback.¶
Feedback Type: A Relay-visible Track Property that identifies whether a Feedback Track terminates at the Adjacent Media Publisher or is delivered to the Media Original Publisher.¶
MMF (MoQ Multimodal Feedback): A receiver report at the MoQ layer containing per-Object delivery status.¶
Cross-Layer Control Interface: A mechanism for the MoQ layer to issue control commands to CC algorithms; the specific form is implementation- defined.¶
QUIC layer feedback mechanisms (ACK, Receive Timestamps) operate at the packet level, leaving the following blind spots at the MoQ layer:¶
| Blind Spot | Description |
|---|---|
| Object Semantics | QUIC ACK confirms packets but cannot perceive frame integrity, type, or deadline |
| Frame-Level Timing | QUIC ACK provides packet-level delay but cannot provide inter-Object arrival timing |
| Playback Progress | QUIC layer cannot know peer's playback buffer level or application-layer consumption state |
This document defines a MoQ-layer feedback mechanism (MMF) that supplements Object-level semantic signals which are unavailable at the QUIC layer. MMF serves both the application layer (per-Object delivery status) and CC algorithms (aggregate statistics injection). MMF enables senders to reduce sending quality before the peer's playback buffer is depleted, rather than passively responding after stuttering occurs.¶
In relay-based audio/video conferences, media can traverse a cascade of multiple relays before reaching participants. Adaptive bitrate is commonly used in such topologies to preserve the participants' quality of experience (QoE) as downstream path conditions change. Implementations can support adaptive bitrate in two ways:¶
Representation tiers at the Media Original Publisher: The Media Original Publisher transcodes the media into multiple resolution and bitrate tiers, allowing a suitable tier to be selected for each participant. This approach is appropriate for conferences with many participants because the tiers can be shared. In a small conference with only two or three participants, however, most tiers may remain unused, making their transcoding cost a waste of resources.¶
Multi-level feedback-driven adaptation: The last-hop Relay combines participant feedback with its local forwarding context and generates feedback that is meaningful to the Media Original Publisher. The Media Original Publisher considers this information when choosing an appropriate source bitrate. This approach avoids generating unused tiers and is suitable for small conferences or when the Media Original Publisher does not provide tiered transcoding.¶
By exposing delivery quality across the relay topology, MMF can support the second approach and help the Media Original Publisher make bitrate decisions before late or lost Objects degrade participant QoE.¶
This mechanism adopts a three-layer architecture: the application layer serves as the media source, the transport layer implements CC algorithms, and the MoQ layer resides in between, responsible for semantic understanding and signal distribution.¶
MMF does not restrict the type of application-layer media sources. Two typical media source types are:¶
| Media Source Type | Characteristics | MMF-Driven Adjustments |
|---|---|---|
| Traditional Media (encoder/camera/live streaming) | Unidirectional output, controllable frame rate/bitrate | Unidirectional adjustment: encoding bitrate, frame rate, resolution, ABR Track switching |
| AI Inference Pipeline (multimodal inference engine) | Bidirectional interaction, tunable generation parameters | Bidirectional adjustment: above general adjustments + inference parameters (chunk_size, flush strategy) |
Both media source types share the same MMF format; the difference lies only in the adjustable actions that can be taken after consuming MMF.¶
The MoQ layer assumes two responsibilities in the three-layer architecture:¶
Semantic Translation: The MoQ Track/Object/Group model provides feedback with frame-level semantics. MMF reports Object delivery status (complete, expired, lost) rather than packet-level status.¶
Control Hub: The MoQ layer synthesizes MMF feedback and local transport state, driving application-layer adjustments upward via callbacks (encoding bitrate, frame rate) and instructing CC to adjust sending rate downward via the cross-layer control interface (pacing_rate, pacing_gain). The MoQ layer can also directly execute certain adjustments (ABR Track switching, Object transmission frequency control) without requiring application-layer media source cooperation.¶
The Feedback Track is a normal MoQ Track, at the same level as audio/video/text Tracks. This mechanism introduces no new QUIC frames or MOQT control messages.¶
CC algorithms (BBR, GCC, etc.) are responsible for congestion detection and bandwidth estimation based on local QUIC ACK and receive-ts. In real-time media scenarios, the MoQ layer issues control commands (pacing_rate, pacing_gain) to CC via the cross-layer control interface (Section 3.3); CC algorithms SHOULD execute these commands. The MoQ layer makes decisions by synthesizing three sources of information: MMF feedback, local CC output (BWE), and frame-level statistics (Section 9.1), achieving higher information completeness than CC algorithms alone. An integration example is provided in Section 9.4.¶
CC algorithms rely on per-packet delay signals for bandwidth estimation and congestion detection; this signal is provided by QUIC receive-ts ([quic-receive-ts]). MMF operates at the MoQ layer, forming a dual-layer feedback which could cooperate with QUIC receive-ts. Both mechanisms can be enabled simultaneously in implementations.¶
| Feedback Layer | Granularity | Hop | CC Role | Application Layer Role |
|---|---|---|---|---|
| QUIC receive-ts | per-packet (~us) | QUIC connection layer | Primary signal (delay gradient, BW est.) | None |
| MoQ MMF | per-Object (~ms) | Hop-local or across Relays | MoQ layer synthesizes and issues control commands | Primary signal (bitrate/frame rate/ABR/inference parameter adjustment) |
The two layers cover different granularities:¶
QUIC receive-ts provides per-packet inter-arrival delta, enabling CC algorithms to perform delay-based congestion detection and bandwidth estimation.¶
MMF supplements additional signals:¶
Per-Object Signals: QUIC transport layer cannot determine whether an Object is complete or arrived within deadline. MMF provides per-Object status (RECEIVED_LATE, NOT_RECEIVED, etc.).¶
Application-Layer Metrics: Playout headroom (PLAYOUT_AHEAD), receiver-side bandwidth estimation, etc.¶
Implementations would still need to support both QUIC receive-ts ([quic-receive-ts]) and MMF simultaneously when both extensions are negotiated.¶
QUIC receive-ts carries per-packet reception timestamps (Timestamp Range / Timestamp Delta) via ACK_EXTENDED frames, enabling CC algorithms to compute inter-arrival delta (delay gradient) and bandwidth estimation. Its role is equivalent to TWCC in WebRTC:¶
QUIC receive-ts: per-packet reception timestamps --> delay-based CC (GCC/SQP, etc.)¶
MMF: per-Object delivery status --> application-layer adaptation + MoQ-layer CC control¶
Compared to WebRTC GCC+TWCC, this framework adds a per-Object semantic feedback layer on top of per-packet feedback. TWCC only provides packet-level arrival times and cannot express Object completeness, expiration status, or playout headroom.¶
MoQ implementations could provide a cross-layer control interface that enables the MoQ layer to issue control commands to CC algorithms. The specific form of the interface is implementation-defined.¶
Distinct from approaches that pass raw data to CC algorithms for independent judgment, this mechanism could help the MoQ layer to achieve better performance. The MoQ layer possesses three kinds of information resource: MMF feedback, local CC output (BWE), and frame-level statistics (Section 9.1), achieving higher information completeness than CC algorithms alone.¶
CC algorithms could still run their own congestion detection logic, or adapted to accept control commands issued by the MoQ layer.¶
Control Commands:¶
| Command | Description |
|---|---|
target_bitrate
|
Target encoding bitrate computed by MoQ layer from BWE and MMF; notifies CC of current application-layer sending budget |
pacing_gain
|
Sending gain coefficient; MoQ layer calculates from MMF signals (Object loss rate, expiration rate, playout headroom); CC may execute as pacing_rate = BWE x pacing_gain
|
pacing_rate
|
Directly specify sending rate; MoQ layer calculates and issues in scenarios like frame-level pacing (Section 9.1.4) |
MoQ Layer Decision Inputs:¶
The MoQ layer synthesizes the following signals for control decisions:¶
MMF Signals (from peer): Object loss rate, expiration rate, Avg Inter-Arrival Delta, PLAYOUT_AHEAD_MS¶
CC Output (from local): BWE, RTT, loss rate¶
Frame-Level Statistics (from local, Section 9.1.3): per-Object transmission/loss/delivery duration¶
CC Algorithm Behavior:¶
CC algorithms SHOULD execute control commands after receiving them:¶
Upon pacing_gain: Update sending rate as pacing_rate = BWE x pacing_gain¶
Upon pacing_rate: Use this value directly as sending rate¶
Upon target_bitrate: Record current application-layer sending budget for internal decision reference¶
When no control commands are issued by the MoQ layer, CC algorithms operate normally according to their own logic.¶
The cross-layer control interface is optional. CC algorithms that do not support this interface can still operate independently but cannot benefit from MMF-driven frame-level control capabilities.¶
The MMF report direction described in the preceding sections is from client to server, reporting delivery quality of downstream media (audio_response, text_response). In streaming input scenarios, the server simultaneously subscribes to upstream media (audio_input, video_input) and MAY establish a reverse feedback Track to report upstream media delivery quality to the client.¶
Client Server
| |
|----- audio_input ------------->| Server subscribes
|<---- input feedback (MMF) -----| Server reports input delivery quality
| |
|<---- audio_response -----------| Client subscribes
|-- output feedback (MMF) ------>| Client reports output delivery quality
| |
¶
Output MMF (client-->server) and Input MMF (server-->client) use the same report format (Section 6). Their purposes differ:¶
Output MMF: Server adjusts encoding bitrate, inference parameters, and CC based on it.¶
Input MMF: Client adjusts upstream behavior based on it:¶
Input MMF is optional. Support of the input MMF is declared via bit-2 of the Setup Parameter bitmap. Input and output feedback independently use the Feedback Track naming and type rules in Section 5.¶
MMF supports deployments in which feedback is consumed by the immediate media-path peer as well as deployments in which feedback is delivered to the Media Original Publisher. The Feedback Type Track Property defined in Section 5.1 identifies the intended consumer and required Relay behavior.¶
In a cascaded Relay architecture, media from a Media Original Publisher traverses multiple Relays before reaching a Subscriber. The Subscriber is the feedback source, the Relay adjacent to the Subscriber can consume feedback for the last-mile path, and the Relay chain can carry a separate Feedback Track to the Media Original Publisher.¶
Media: Media Original Publisher -> ... -> L2 Relay -> L1 Relay -> Subscriber
HOP_FEEDBACK: L1 Relay <- Subscriber
ORIGIN_FEEDBACK: Media Original Publisher <- ... <- L2 Relay <- L1 Relay
¶
The following Feedback Tracks serve different consumers:¶
A HOP_FEEDBACK Track terminates at the L1 Relay. It enables the L1
Relay to react to last-mile delivery conditions, for example by selecting an
ABR Track, changing Object scheduling or priority, or adjusting pacing on the
downstream connection.¶
The L1 Relay MAY use received HOP_FEEDBACK together with its local media
forwarding state to generate a new ORIGIN_FEEDBACK Track when required by
application policy. It MUST NOT relabel or mechanically forward the
HOP_FEEDBACK Objects as ORIGIN_FEEDBACK. The new report can provide the
Media Original Publisher with context suitable for source bitrate, frame-rate,
resolution, or generation-rate adaptation.¶
An ORIGIN_FEEDBACK Track can traverse zero or more Relays. When Relays are
present, its MMF Payload remains opaque to intermediate Relays. In a direct
Subscriber-to-Media-Original-Publisher connection, the Subscriber can publish
ORIGIN_FEEDBACK without an intervening Relay.¶
A Subscriber behind an L1 Relay SHOULD publish its feedback report to that Relay
using HOP_FEEDBACK. A deployment MAY instead allow Subscriber-originated
ORIGIN_FEEDBACK when the Media Original Publisher has sufficient context to
interpret it.¶
The relative importance of the two Feedback Types depends on the application:¶
Live streaming: The Media Original Publisher commonly provides an ABR
ladder. The L1 Relay primarily consumes HOP_FEEDBACK and selects a
representation suitable for the last-mile path.¶
Audio/video conferencing: The Media Original Publisher might need
feedback from every participant session, particularly when it does not
provide an ABR ladder. ORIGIN_FEEDBACK gives the Media Original
Publisher the information needed for source-rate adaptation. In large
conferences, forwarding every participant report can produce a 1:N feedback
implosion. A Relay performing aggregation acts as a new Feedback Publisher
and publishes a distinct Feedback Track. The aggregation format and policy
are outside the scope of this document.¶
Other applications include live-agent media between a user and an inference
service, cloud rendering, and cloud gaming. These applications can use
ORIGIN_FEEDBACK so that the source reacts directly to receiver QoE.¶
The Feedback Track is a normal MoQ Track where the Payload of each Object is an MMF. Each MMF is published as an independent Object with monotonically increasing Object ID within a Group.¶
Each Feedback Track has exactly one Feedback Type and MUST NOT mix
HOP_FEEDBACK and ORIGIN_FEEDBACK. The type controls Track distribution and
is carried in the Relay-visible MMF_FEEDBACK_TYPE Track Property. A feedback
source that generates both types MUST publish two distinct Feedback Tracks.¶
The MMF_FEEDBACK_TYPE Track Property has a varint value:¶
| Value | Name | Description |
|---|---|---|
0x00
|
HOP_FEEDBACK
|
Intended for the Adjacent Media Publisher on the current MOQT session |
0x01
|
ORIGIN_FEEDBACK
|
Intended for the Media Original Publisher across zero or more Relays |
Every Feedback Track MUST include the MMF_FEEDBACK_TYPE Track Property (TBD2)
in its PUBLISH Track Properties. This Property is immutable for the lifetime of
the Track. A Relay that recognizes it MUST NOT modify or remove it. A Relay that
does not recognize it forwards and caches it according to the unknown Property
rules in [MoQTransport]. An MMF-aware Relay uses this Property without
inspecting MMF Object Payloads. A terminal feedback consumer that receives an
unsupported value MUST reject the Feedback Track.¶
The Group division strategy for Feedback Track is implementation-defined. It is RECOMMENDED to use a single Group (Group ID = 0) with continuously incrementing Object IDs to simplify implementation.¶
Each Feedback Track MUST be associated 1:1 with a media Track. The association is encoded in the Feedback Full Track Name (Section 5.2) and is not repeated in MMF reports. This Full Track Name binding is the media Track binding mechanism defined by this document; no per-Object binding parameter is required.¶
When feedback is needed for multiple media Tracks, independent Feedback Tracks MUST be established separately.¶
Each feedback publisher or publication session MUST use a distinct Feedback Full Track Name. This prevents independent publishers from producing different Payloads for the same Group ID and Object ID on what MOQT would otherwise treat as a single Track.¶
The Feedback Full Track Name carries the information that Relays need to
distribute a Feedback Track without inspecting Object Payloads. Let ++ denote
appending fields to a Track Namespace tuple. A Feedback Track MUST use:¶
Track Namespace: The media Track Namespace with three fields appended in
this order: the literal mmf, the feedback type label, and the feedback
source ID.¶
Track Name: The Track Name of the associated media Track.¶
The feedback-type-label is the ASCII string hop-feedback for HOP_FEEDBACK
or origin-feedback for ORIGIN_FEEDBACK. It enables Namespace prefix
matching. The label MUST agree with the MMF_FEEDBACK_TYPE Track Property. A
node that detects a mismatch MUST reject the Feedback Track.¶
The feedback-source-id is an opaque, non-empty byte string selected by the
Feedback Publisher. It MUST distinguish that publisher and publication session
from every other Feedback Publisher and session for the associated media Track.
It is not required to identify a user and MUST NOT be interpreted as a user
identity. A publisher MUST select a new value before reusing a Group ID and
Object ID pair or restarting its Report Sequence space.¶
For example, feedback for media Full Track Name
(example.com, meeting, audio_response) can use:¶
(example.com, meeting, mmf, hop-feedback, receiver-17, audio_response)
(example.com, meeting, mmf, origin-feedback, relay-l1-4, audio_response)
¶
The same naming construction applies to output and input feedback. The media Track being reported determines the direction; a separate Track Name prefix is not used.¶
A node receiving a PUBLISH for a Feedback Track reconstructs the associated
media Full Track Name by removing the final three Namespace fields and retaining
the Feedback Track Name. If it cannot identify the associated media Track or
does not support the indicated type, it SHOULD respond with REQUEST_ERROR.¶
The Feedback Track is established by the feedback generator (a media receiver or a Relay generating new feedback) as Publisher through MOQT's PUBLISH / PUBLISH_OK negotiation.¶
For a HOP_FEEDBACK Track, the terminal feedback consumer is the Adjacent
Media Publisher on that MOQT session. The consumer accepts the PUBLISH and MUST
NOT advertise or forward that Feedback Track on another MOQT session.¶
An L1 Relay that generates ORIGIN_FEEDBACK is a new Feedback Publisher. It
uses a new Feedback Full Track Name, Report Sequence space, and MMF Payload. It
can derive that Payload from HOP_FEEDBACK, local media transmission state, and
application policy.¶
An ORIGIN_FEEDBACK type does not create a route by itself. Before feedback
Objects can be delivered, an interest and authorization chain MUST be
established between the Media Original Publisher and the Feedback Publisher:¶
The Media Original Publisher, acting as a Feedback Subscriber, expresses
interest in the origin-feedback Namespace for the media Track. It can use
SUBSCRIBE_NAMESPACE for the corresponding Namespace prefix, or use
deployment-specific prior interest and authorization as permitted by
[MoQTransport].¶
Each intermediate Relay binds the Feedback Track to the media forwarding state identified by Section 5.2. It propagates feedback interest only to downstream peers to which it forwards the associated media Track. Feedback Objects travel in the opposite direction, toward the peer from which the Relay received that media Track.¶
The Feedback Publisher sends PUBLISH for its unique Feedback Full Track Name. Each hop uses the PUBLISH / PUBLISH_OK and SUBSCRIBE / SUBSCRIBE_OK procedures in [MoQTransport] to establish forwarding with Forward State 1.¶
PUBLISH_NAMESPACE is not a route discovery mechanism. A Relay MUST NOT use it to
search a richly connected Relay topology for a path to the Media Original
Publisher. A Relay forwards ORIGIN_FEEDBACK only toward the peer from which it
received the associated media Track, and MUST NOT forward it back toward the
feedback publisher or another downstream media peer. If there is no unique
reverse media-path binding, the Relay MUST reject the Feedback Track. These
rules prevent a feedback loop in the single-upstream media topology defined by
this document.¶
If any hop has no matching interest, lacks authorization, has no media-path
binding, or rejects the request, that hop MUST reject establishment using the
applicable MOQT request error. The Feedback Publisher MUST NOT send MMF Objects
until its PUBLISH is accepted. It MAY continue or fall back to a separately
established HOP_FEEDBACK Track, but it MUST NOT relabel a rejected Track to
bypass the failure.¶
Relays route both Feedback Track types solely from the Full Track Name and
MMF_FEEDBACK_TYPE Track Property. In accordance with [MoQTransport], the
Object Payload is opaque to a Relay and is not processed to make a forwarding
decision. An ORIGIN_FEEDBACK MMF Payload can therefore be protected between
the Feedback Publisher and the Media Original Publisher. A HOP_FEEDBACK MMF
Payload can be protected for its adjacent terminal feedback consumer.¶
Direct Establishment Flow Example:¶
Media Receiver Media Original Publisher
(Media Subscriber / (Media Publisher /
Feedback Publisher) Feedback Subscriber)
| |
| SUBSCRIBE(track=audio_response) | (1) Subscribe media Track
|----------------------------------->|
| SUBSCRIBE_OK |
|<-----------------------------------|
| |
| PUBLISH( | (2) Publish origin-feedback Track
| namespace=media_namespace ++ |
| ("mmf", "origin-feedback", |
| "receiver-17"), |
| track=audio_response, |
| property=MMF_FEEDBACK_TYPE(1)) |
|----------------------------------->|
| PUBLISH_OK |
|<-----------------------------------|
| |
| [Object: MMF seq=0] | (3) Send MMF
|----------------------------------->|
| [Object: MMF seq=1] |
|----------------------------------->|
| ... |
¶
Lifecycle Rules:¶
The Feedback Track lifecycle SHOULD align with the subscribed media Track it covers. After the media Track publisher sends PUBLISH_DONE for the media Track, the Feedback Track publisher (i.e., the media receiver) SHOULD send PUBLISH_DONE for the Feedback Track after transmitting the final MMF and stop publishing Objects.¶
When a MOQT session carrying a Feedback Track is disconnected, a Relay MUST
discard the associated forwarding state and MUST NOT re-advertise the old
Feedback Track after reconnecting. The Feedback Publisher establishes a new
Feedback Track with a new feedback-source-id; its Report Sequence SHOULD
restart from 0.¶
Feedback is time-sensitive. A Feedback Publisher SHOULD use the
MAX_CACHE_DURATION Track Property defined by [MoQTransport] to bound the
period for which MMF Objects can be served from cache. A terminal feedback
consumer MUST NOT apply an MMF from a previous publication session.¶
The Feedback Track SHOULD be carried over QUIC Stream (consistent with ordinary MoQ Objects).¶
The Subscriber Priority for Feedback Track SHOULD be set lower than media Tracks ([MoQTransport], Section 7). Example priority assignment:¶
| Track Type | Subscriber Priority | Description |
|---|---|---|
audio_response
|
0 (highest) | Audio media |
video_response
|
1 | Video media |
| Feedback Track | 3 | MMF feedback |
When bandwidth contention occurs, media data SHOULD take precedence over feedback data transmission.¶
This section defines the binary encoding format of MMF. All integer fields use QUIC Variable-Length Integer encoding (RFC 9000, Section 16) unless otherwise specified.¶
Fields marked as "signed encoding" use ZigZag mapping and are transmitted as unsigned QUIC varint:¶
Encoding: unsigned = (signed << 1) ^ (signed >> 63)¶
Decoding: signed = (unsigned >>> 1) ^ -(unsigned & 1)¶
Mapping examples: 0 -> 0, -1 -> 1, 1 -> 2, -2 -> 3, 2 -> 4.¶
MoQ Multimodal Feedback {
Report Timestamp (i),
Report Sequence (i),
Object Entry Count (i),
Object Entry (..) ...,
Summary Stats (..),
Optional Metric Count (i),
Optional Metric (..) ...,
}
¶
The MMF format version is negotiated via Setup Parameter (Section 7.1) and is not repeated in each report. This document defines version 0.¶
Each MMF reports Object delivery status for a single media Track associated with its Feedback Track (1:1 association, see Section 5.1).¶
Report Timestamp (varint): The moment when the report is generated, using receiver's local monotonic clock value in microseconds. This value is only used for Receive Timestamp Delta chain anchoring and report ordering, not for cross-end time alignment. Monotonic clock MUST be used.¶
Report Sequence (varint): Monotonically increasing from 0 independently for
each Feedback Track. A gap can indicate an omitted report only when the
publication policy for that Track requires a contiguous Report Sequence. An
Object ID gap alone, without a Prior Object ID Gap property as defined by
[MoQTransport], MUST NOT be interpreted as feedback loss. Because
HOP_FEEDBACK and ORIGIN_FEEDBACK use separate Tracks, terminating one type
cannot create sequence gaps in the other type's sequence space.¶
Object Entry Count (varint): Number of Object Entries that follow. When the value is 0, the report contains only Summary Stats (for heartbeat purposes).¶
Object Entry {
Group ID (i),
Object ID (i),
Status (i),
[Receive Timestamp Delta (i)],
}
¶
Object Entries within the same MMF MUST be sorted in ascending order by
(Group ID, Object ID).¶
The Object ID (varint) within the identified Group of the associated media Track.¶
The media Full Track Name from Section 5.2, Group ID, and Object ID together identify the media Object being reported. A Relay forwarding the same media Track preserves these coordinates. A Relay that changes the Full Track Name or media Object coordinates is publishing a different media Track and MUST NOT associate its Feedback Track with the pre-transformation media Track.¶
Conditional presence field (varint, signed encoding): Present only when Status
is RECEIVED (0x00) or RECEIVED_LATE (0x01). Encoding rules:¶
First received Object within the same MMF (i.e., the first entry with
Status RECEIVED or RECEIVED_LATE when iterating through the list): Delta
is the offset of the Object's arrival time relative to Report Timestamp in
microseconds, encoded as signed varint (negative values indicate arrival time
earlier than report generation time).¶
Subsequent received Objects: Delta is the offset of the Object's arrival
time relative to the arrival time of the most recent entry with Status
RECEIVED or RECEIVED_LATE that precedes it in the list, encoded as signed
varint.¶
NOT_RECEIVED and PARTIALLY_RECEIVED entries are skipped in the delta chain.¶
Since Object Entries are sorted by (Group ID, Object ID) while Objects may
arrive out of order, delta values can be negative (indicating the Object arrived
earlier than the previous received Object in the list). Negative delta from
reordering is a valid network state signal.¶
This Delta chain encoding approach is consistent with QUIC Receive Timestamps (draft-ietf-quic-receive-ts-00), but at Object granularity rather than packet. For small Objects (audio frames ~200B, approximately 1 packet/Object), the Delta sequence approaches per-packet precision.¶
| Value | Name | Description |
|---|---|---|
0x00
|
RECEIVED
|
Completely received and within delivery deadline |
0x01
|
RECEIVED_LATE
|
Completely received but exceeded delivery deadline |
0x02
|
NOT_RECEIVED
|
No bytes received at report generation time |
0x03
|
PARTIALLY_RECEIVED
|
Partial bytes received but Object is incomplete |
Receiver MUST determine Object expiration based on local playback deadline:¶
An Object is RECEIVED_LATE when its arrival time exceeds its expected playback
moment.¶
When playback deadline is unavailable (e.g., non-real-time playback scenarios),
receiver SHOULD report RECEIVED rather than RECEIVED_LATE.¶
Receiver SHOULD report an Object as NOT_RECEIVED when one of the following
conditions is met:¶
A subsequent Object with a larger Object ID in the same Group has arrived, but this Object has not.¶
The Object's expected arrival time has exceeded 2 x expected_interval
(see Section 6.4.6) without arrival, and no subsequent Object is available for
reference.¶
Condition 2 covers the "last Object lost" scenario (no subsequent Object to trigger Condition 1).¶
Receiver MUST NOT report NOT_RECEIVED for Objects that are not yet reasonably
expected to arrive.¶
Applicable to Objects carried over QUIC Stream: When a Stream is terminated by
RESET_STREAM or closed due to timeout, Objects with partially received data
SHOULD be reported as PARTIALLY_RECEIVED.¶
The timeout threshold used to determine whether a partially received Object
should be reported as PARTIALLY_RECEIVED is application-defined. Different
applications may have different latency requirements (e.g., real-time voice vs.
file transfer), and the receiver's application layer is best positioned to
decide when an incomplete Object is no longer useful. Implementations SHOULD
allow the application layer to configure or signal this timeout value.¶
For Objects carried over QUIC Datagram: Since QUIC Datagrams are not
retransmitted by the transport layer, any Object whose Datagram(s) are lost
results in incomplete data at the receiver. If the receiver detects that some
but not all Datagrams constituting an Object have arrived, and the remaining
Datagrams are not expected to arrive (e.g., a subsequent Object has arrived or
the application-defined timeout has expired), the Object SHOULD be reported as
PARTIALLY_RECEIVED. If no Datagrams for the Object have arrived, the Object
SHOULD be reported as NOT_RECEIVED instead.¶
Summary Stats {
Report Interval (i),
Total Objects Evaluated (i),
Objects Received (i),
Objects Received Late (i),
Objects Lost (i),
Avg Inter-Arrival Delta (i),
}
¶
Summary Stats MUST always be included in every MMF, not controlled by negotiation bitmap. It provides windowed aggregate information, enabling lightweight CC consumers that do not parse Object Entry to obtain effective signals. The MoQ layer can compute control decisions based on this block and issue them to CC algorithms via the cross-layer control interface (Section 3.3).¶
The Report Interval window of Summary Stats is independent from the coverage of Object Entries. Object Entries MAY include Objects outside the Report Interval window (e.g., continuously reported NOT_RECEIVED entries, see Section 8.4).¶
The time window length covered by this report (varint), in microseconds. This
window spans from Report Timestamp - Report Interval to Report Timestamp.
RECOMMENDED value is 50000-200000 (50-200ms).¶
Total number of Objects (varint) evaluated within the Report Interval window.
Includes Objects of all statuses. MUST equal
Objects Received + Objects Received Late + Objects Lost.¶
Number of Objects (varint) with status RECEIVED within the window.¶
Number of Objects (varint) with status RECEIVED_LATE within the window.¶
Number of Objects (varint) with status NOT_RECEIVED or PARTIALLY_RECEIVED
within the window.¶
Average arrival interval deviation (varint, signed encoding) of consecutive received Object pairs within the window, in microseconds. Calculation method:¶
For consecutive received Object pairs (i-1, i) sorted by arrival time within the window:¶
delta(i) = (A(i) - A(i-1)) - expected_interval
Avg Inter-Arrival Delta = mean(delta(i)) for all i
¶
Where A(i) is the arrival time of Object i, and expected_interval is the
expected arrival interval.¶
Methods to determine expected_interval (by priority):¶
Known media frame rate (e.g., 50 obj/s --> 20000us).¶
Historical average arrival interval within current session (sliding window).¶
If neither method is available, receiver SHOULD use method 2 or set this field to 0.¶
Positive values indicate Object arrival interval greater than expected (increased queuing), negative values indicate less than expected. When fewer than 2 received Objects exist in the window, this field MUST be 0.¶
Optional Media Metrics immediately follow Summary Stats. Optional Metric Count
(varint) specifies the number of subsequent Optional Metrics; a value of 0
indicates no optional metrics are included.¶
Each metric uses Key-Value-Pair encoding (draft-ietf-moq-transport-17, Section 1.4.2):¶
Optional Metric {
Metric Type (i),
Metric Value (i),
}
¶
Defined metric types are divided into two categories: Application-Layer Metrics and QUIC Layer Summary Metrics.¶
Application-Layer Metrics:¶
| Type | Name | Unit | Description |
|---|---|---|---|
0x02
|
PLAYOUT_AHEAD_MS
|
milliseconds | Remaining time until playback stall at receiver, i.e., buffered but not yet played media duration. Smaller values indicate closer to stall (0 = currently stalled). |
0x04
|
ESTIMATED_BANDWIDTH_KBPS
|
kbps | Available bandwidth estimate observed at receiver. Can be calculated as bytes received in window / window duration. For sender to cross-reference with local bandwidth estimation. |
QUIC Layer Summary Metrics:¶
The following metrics expose the receiver's local QUIC connection transport state to the sender for CC algorithm cross-validation.¶
| Type | Name | Unit | Description |
|---|---|---|---|
0x10
|
PEER_RTT_US
|
microseconds | Receiver's local QUIC connection smoothed RTT, corresponding to smoothed_rtt in RFC 9002. For sender to cross-validate with local RTT estimation. |
0x12
|
PEER_LOSS_RATE
|
per mille | Receiver's local QUIC connection packet loss rate within Report Interval, expressed in per mille (e.g., 50 = 5.0%). |
MMF's core CC signals rely on Receive Timestamp Delta in Object Entry
(Section 6.2.3, referencing QUIC receive-ts / WebRTC TWCC per-packet delta
encoding approach) and Summary Stats (Section 6.4), not Optional Metrics.
Optional Metrics serve only as supplements.¶
Type values 0x00-0x1f are reserved for this specification. Values 0x20 and
above are available for application-layer custom use.¶
Receiver MUST ignore unrecognized Metric Types.¶
Optional Media Metrics MAY be included in MMF only when both parties have
declared bit1=1 in Setup negotiation (Section 7). When not negotiated or
bit1=0, Optional Metric Count MUST be 0.¶
A single MMF is RECOMMENDED not to exceed 1200 bytes to avoid QUIC packet fragmentation.¶
When the number of Objects to report exceeds the capacity of a single MMF, receiver SHOULD:¶
Prioritize including recent Object Entries (largest media Object locations).¶
Trim the oldest Object Entries.¶
Ensure Summary Stats covers the complete Report Interval window (Summary Stats is not affected by Object Entry trimming).¶
The following is an encoding structure of a typical MMF reporting delivery status
of the 5 most recent Objects on the audio_response Track. Object Entries are
sorted in ascending order by (Group ID, Object ID). Signed fields use
ZigZag-encoded unsigned values (encoding convention at the beginning of
Section 6). The Feedback Track carries the MMF_FEEDBACK_TYPE Track Property
with value ORIGIN_FEEDBACK.¶
``` MoQ Multimodal Feedback: Report Timestamp: 2000000 (2000000us = 2s since setup) Report Sequence: 10 (10th report) Object Entry Count: 5 (5 Objects)¶
Object Entry [0]: (smallest media Object location, first in list) Group ID: 7 Object ID: 96 Status: 0x00 (RECEIVED) Recv Ts Delta: 169999 (ZigZag(-85000): 85ms before Report Timestamp) (First received Object, baseline=Report Timestamp)¶
Object Entry [1]: Group ID: 7 Object ID: 97 Status: 0x02 (NOT_RECEIVED) (No Recv Ts Delta)¶
Object Entry [2]: Group ID: 7 Object ID: 98 Status: 0x01 (RECEIVED_LATE) Recv Ts Delta: 100000 (ZigZag(+50000): 50ms later than Object 96) (Skip NOT_RECEIVED 97, baseline=Object 96)¶
Object Entry [3]: Group ID: 7 Object ID: 99 Status: 0x00 (RECEIVED) Recv Ts Delta: 40000 (ZigZag(+20000): 20ms later than Object 98)¶
Object Entry [4]: Group ID: 7 Object ID: 100 Status: 0x00 (RECEIVED) Recv Ts Delta: 40000 (ZigZag(+20000): 20ms later than Object 99)¶
Summary Stats: Report Interval: 100000 (100000us = 100ms) Total Objects Evaluated: 5 Objects Received: 3 Objects Received Late: 1 Objects Lost: 1 Avg Inter-Arrival Delta: 6000 (ZigZag(+3000): avg arrival interval 3ms larger)¶
Optional Metric Count: 2 Optional Metric [0]: Metric Type: 0x02 (PLAYOUT_AHEAD_MS) Metric Value: 150 (playout headroom 150ms) Optional Metric [1]: Metric Type: 0x04 (ESTIMATED_BANDWIDTH_KBPS) Metric Value: 800 (estimated bandwidth 800kbps) ```¶
In this example, the Track Property identifies an ORIGIN_FEEDBACK Track.
Intermediate Relays forward the Track toward the Media Original Publisher
without inspecting its MMF Payload. Object 97 in Group 7 is lost and Object 98
arrived late. Object 98's delta (+50ms) is significantly larger than normal
interval (~20ms). Avg Inter-Arrival Delta is positive (+3ms) indicating
larger-than-expected arrival intervals. PLAYOUT_AHEAD_MS is only 150ms. These
signals combined indicate deteriorating network conditions.¶
During MOQT Setup phase, both parties declare Multimodal Feedback capability via Setup Parameter.¶
MOQT_MULTIMODAL_FEEDBACK Setup Parameter {
Type = TBD1 (i),
Length (i),
Value (i),
}
¶
The Value field is a capability bitmap (varint) with the following bit
definitions:¶
| Bit | Name | Description |
|---|---|---|
| 0 |
OUTPUT_FEEDBACK
|
Support output direction Feedback Track (receiver-->sender) |
| 1 |
OPTIONAL_METRICS
|
Support Optional Media Metrics (Section 6.5) |
| 2 |
INPUT_FEEDBACK
|
Support input direction Feedback Track (sender-->receiver, Section 3.4) |
| 3-62 | Reserved | Sender MUST set to 0, receiver MUST ignore |
Negotiation Example:¶
Client Server
| |
| CLIENT_SETUP( |
| version=16, |
| params=[ |
| {type=0x00, value=0x02}, | (ROLE=Publisher)
| {type=TBD1, value=0x03} | (MULTIMODAL_FEEDBACK: bit0|1=1)
| ]) |
|----------------------------------->|
| |
| SERVER_SETUP( |
| version=16, |
| params=[ |
| {type=0x00, value=0x03}, | (ROLE=PubSub)
| {type=TBD1, value=0x01} | (MULTIMODAL_FEEDBACK: bit0=1)
| ]) |
|<-----------------------------------|
| |
| Negotiation Result: |
| bit0=1 (Output Feedback) |
| bit1=0 (Client declared but |
| Server did not, |
| Optional Metrics disabled) |
¶
Feature enable conditions (both parties MUST declare corresponding bit as 1):¶
| Feature | Enable Condition | Dependency |
|---|---|---|
| Output Feedback | Both bit0=1 | None |
| Optional Media Metrics | Both bit1=1 | Output Feedback enabled |
| Input Feedback | Both bit2=1 | None |
When a feature is not enabled:¶
Receiver MUST NOT publish Feedback Track in corresponding direction.¶
When sender receives PUBLISH request for Feedback Track in un-negotiated
direction, it SHOULD respond with REQUEST_ERROR (draft-ietf-moq-transport-17,
Section 9.8).¶
MMF MUST NOT include un-negotiated optional fields (e.g., Optional Metrics).¶
The Setup Parameter is required for an endpoint that generates or consumes MMF.
An intermediate Relay that only forwards an ORIGIN_FEEDBACK Track does not
need to parse MMF or negotiate an additional Feedback Type capability. It
forwards the MMF_FEEDBACK_TYPE Track Property according to the unknown Property
rules in [MoQTransport].¶
When peer's Setup does not include MOQT_MULTIMODAL_FEEDBACK Parameter, it is
equivalent to Value=0 (no Multimodal Feedback capability supported).¶
This end MUST NOT proactively establish Feedback Track.¶
This version does not support runtime changes to Multimodal Feedback capability. If change is needed, MoQ session MUST be re-established.¶
Receiver MUST record the arrival time of each Object. Arrival time is defined as the moment when the last byte of the Object arrives at the receiver's MoQ layer. Implementation MUST use monotonic clock, unaffected by system time adjustments. Time precision SHOULD be no less than 1 millisecond, RECOMMENDED to be microsecond-level.¶
Receiver MUST maintain delivery status for each known Object:¶
Last byte of Object arrives and within deadline: RECEIVED (0x00).¶
Last byte of Object arrives but exceeds deadline: RECEIVED_LATE (0x01).¶
Object has not arrived but is reasonably considered lost (see Section 6.3):
NOT_RECEIVED (0x02).¶
Object partially arrived and carrying Stream is closed: PARTIALLY_RECEIVED
(0x03).¶
Object status MAY be updated in subsequent MMF. For example, from NOT_RECEIVED
to RECEIVED (when a delayed Object is eventually received). Therefore, counts
such as Objects Lost in Summary Stats reflect an observation snapshot at
report generation time and are not guaranteed to be consistent with final
statistics. Sender SHOULD use them as immediate signals rather than precise
statistics.¶
Receiver SHOULD generate MMF at the following recommended frequencies:¶
| Scenario | Recommended Frequency | Description |
|---|---|---|
| Audio Track (~50 Object/s) | Every 50-100ms | High-frequency Objects require dense feedback |
| Video Track (~2-30 Object/s) | Every 100-200ms | Low-frequency Objects can reduce feedback frequency |
| No new Objects arriving | Every 500ms-1s | Heartbeat to prevent sender from misjudging connection state |
Generation frequency SHOULD NOT exceed once per 50ms (to avoid feedback itself consuming excessive bandwidth). Generation frequency SHOULD NOT be lower than once per 2s (to ensure sender receives timely feedback).¶
When receiver detects rapid deterioration in delivery quality (e.g., consecutive Object losses), it MAY immediately generate an additional MMF (without waiting for the scheduled cycle) to accelerate sender response.¶
When generating MMF, receiver SHOULD follow these Object Entry selection strategies:¶
Prioritize covering recent Objects (most recent in time).¶
Total number of Object Entries per MMF is RECOMMENDED not to exceed 50.¶
For Objects already reported in previous MMF with unchanged status, they MAY be omitted.¶
Objects with status NOT_RECEIVED SHOULD be continuously reported (for at
least 3 MMF cycles) until status changes or exceeding the report window.¶
Object Out-of-Order Arrival: Receiver MUST record by actual arrival time without reordering. Arrival time reflects actual network behavior; out-of-order itself is a valid network signal.¶
Duplicate Objects: Receiver SHOULD identify duplicates by Group ID and Object ID, ignore duplicate arrivals, and retain the first arrival time.¶
Feedback Track Publish Failure: Receiver SHOULD retry establishing Feedback Track with backoff strategy. Retry interval is RECOMMENDED to use exponential backoff (initial 1s, maximum 30s).¶
If a sender needs to correlate MMF feedback with local transmission events, it MUST maintain the mapping relationship between media Object coordinates (Full Track Name, Group ID, and Object ID) and QUIC packets. Without this mapping, the sender cannot determine the number of packets, packet loss count, and delivery duration for a single video frame, and the per-Object status reported by MMF cannot be aligned with sender-side statistics.¶
In real-time media scenarios, a MoQ Object SHOULD correspond to an independently decodable media unit (a video frame or an audio frame).¶
This enables per-Object feedback in MMF to directly carry frame-level semantics: Object loss = frame loss, Object expiration = frame expiration. If an Object contains multiple frames or a single frame spans multiple Objects, there will be deviation between the delivery status reported by MMF and the actual media quality.¶
Senders SHOULD avoid merging data from different Objects into the same QUIC packet.¶
If a packet contains data from two Objects, then loss or delay of that packet cannot be attributed to a single Object, leading to:¶
Frame-level packet loss rate statistics distortion (single packet loss affects statistics for both frames)¶
Frame-level delivery time cannot be accurately measured (transmission times of two frames overlap)¶
Per-Object arrival time at the receiver becomes inaccurate¶
During implementation, when the QUIC send queue attempts to append new data to an existing packet, it SHOULD check whether both belong to the same Object; if not, it SHOULD create a new packet.¶
Senders SHOULD maintain the following transmission statistics for each Object:¶
| Statistic | Description |
|---|---|
sent_packets
|
Number of QUIC packets sent for this Object |
lost_packets
|
Number of QUIC packets lost for this Object |
first_sent_time
|
Transmission time of the first packet for this Object |
all_acked_time
|
Time when all packets for this Object are acknowledged |
Based on these statistics, the sender can compute:¶
Frame-level bandwidth sample: object_size / (all_acked_time - first_sent_time)¶
Frame-level packet loss rate: lost_packets / sent_packets¶
Frame-level delivery duration: all_acked_time - first_sent_time¶
These metrics provide the foundation for frame-level BWE and frame-level pacing (Section 9.1.4). Standard CC algorithms (BBR, CUBIC) sample bandwidth at the packet level. Frame-level bandwidth sampling serves as a complementary approach, suitable for real-time video scenarios with large frame size variations (I-frames may be 10x larger than P-frames), helping to reduce noise from single-packet sampling.¶
Whether a CC algorithm provides BWE output depends on the algorithm type. Model-based algorithms such as BBR and GCC provide bandwidth estimation; pure loss-based algorithms like CUBIC only output cwnd without explicit BWE. When the CC algorithm does not provide BWE, the MoQ layer MAY use frame-level bandwidth sampling as the bandwidth estimation source.¶
Real-time video exhibits significant frame size variations. When using a global fixed pacing rate for transmission, large frames (I-frames) will burst a large number of packets in a short time, while small frames (P-frames) underutilize the sending window.¶
Senders SHOULD calculate pacing intervals at Object granularity.¶
The packet sending interval for each Object is RECOMMENDED to be computed as follows:¶
pkt_send_interval = media_pace_duration / (sent_packets - 1)
¶
Where media_pace_duration is the media duration corresponding to this Object (e.g., 33ms@30fps for video, 20ms@50fps for audio). The first packet of an Object is sent immediately, and subsequent packets are sent at equal intervals of pkt_send_interval.¶
This approach distributes an Object's data uniformly across its frame interval. I-frames have denser packet intervals, P-frames have sparser intervals, but neither produces bursts.¶
Frame-level pacing may conflict with CC's pacing rate. When they are inconsistent, senders SHOULD use the lower sending rate to prevent frame-level pacing from bypassing CC's congestion control.¶
After the sender's MoQ layer receives MMF, it exposes the following information to the inference scheduler/ABR through application-layer callbacks:¶
Delivery quality (loss rate, expiration rate) of the associated media Track¶
Per-Object status and timestamps (can be used for detailed analysis)¶
Optional media metrics (playout headroom, bandwidth estimation, etc.)¶
The inference scheduler makes decisions based on the above information (see Section 10 for details).¶
The MoQ layer synthesizes MMF signals and local CC output, computes control decisions, and issues them to CC algorithms via the cross-layer control interface (Section 3.3). CC algorithms do not directly parse MMF, but instead execute control commands from the MoQ layer. Decision inputs, issuable commands, and CC behavior are described in Section 3.3.¶
The core formula of BBR is pacing_rate = bandwidth x pacing_gain.¶
BBR itself estimates bandwidth through ACK sampling and controls pacing_gain via its state machine. In cross-layer control mode, the MoQ layer takes over control of pacing_gain. BBR remains responsible for bandwidth estimation, while pacing_gain is determined by the MoQ layer based on MMF feedback:¶
``` MoQ Layer: 1. Read BBR's BWE 2. Read MMF: Objects Lost, Late, PLAYOUT_AHEAD_MS, Delta 3. Compute pacing_gain (comprehensive judgment) 4. Issue pacing_gain --> CC¶
BBR: 1. Receive pacing_gain 2. pacing_rate = BWE x pacing_gain 3. Send at pacing_rate ```¶
Example logic for MoQ layer computing pacing_gain:¶
Objects Lost > 0 and BBR local loss = 0 --> Reduce pacing_gain to 1.0
(CC local ACK is normal, but peer is actually losing frames; stop probing upward)¶
PLAYOUT_AHEAD_MS < 100ms --> Reduce pacing_gain to 1.0
(Insufficient playout headroom; avoid aggressive probing)¶
Avg Inter-Arrival Delta consistently positive --> Reduce pacing_gain to 0.9
(Receiver-side queuing is worsening; proactively reduce speed)¶
High proportion of Objects Received Late --> Reduce target_bitrate
(Transmission has no packet loss but delay exceeds deadline; reduce per-frame data volume at the source)¶
None of the above conditions met --> Do not issue commands; BBR runs according to its own state machine¶
When the MoQ layer does not issue commands, BBR operates normally according to its own state machine. The MoQ layer overrides pacing_gain only when MMF signals indicate intervention is needed; otherwise, BBR operates fully autonomously.¶
This section describes the usage of MMF in streaming media and AI inference scenarios. Section 10.1 presents a general adaptation framework, and Section 10.2 illustrates with concrete use cases.¶
The following adaptation rules apply to all MoQ streaming media scenarios:¶
| MMF Field (Section) | Adaptation Action | Effect | Applicable Scenarios |
|---|---|---|---|
| PLAYOUT_AHEAD_MS downward trend (6.5) | Reduce encoding bitrate | Less data per frame | Video/Audio/Inference |
| PLAYOUT_AHEAD_MS downward trend (6.5) | Reduce frame rate / Object sending frequency | Reduced transmission volume | Video |
| Objects Lost > 0 (6.4.5) | Reduce sending rate (with CC) | Match available bandwidth | All |
| Objects Received Late > 0 (6.4.4) | Reduce quality to meet deadline | Trade quality for timeliness | All |
| Avg Inter-Arrival Delta increasing (6.4.6) | Preventive quality reduction (before packet loss) | Avoid sudden degradation | All |
| PLAYOUT_AHEAD_MS recovery (6.5) | Gradually restore bitrate/frame rate | Improve experience | All |
These adaptations can be executed at the MoQ publishing layer with per-Object granularity and latency < 1 frame cycle, without requiring application-layer media source cooperation. When the application layer is an AI inference pipeline, MMF can also adjust inference pipeline parameters (real-time flush, dynamic chunk_size).¶
Unidirectional and bidirectional adaptation modes are described in Section 3.4 (Bidirectional MMF).¶
The following use cases assume BBR as the CC algorithm (integration method described in Section 9.4) and illustrate the effects of MMF in different scenarios. All cases follow the strategy of prioritizing audio output and progressively reducing quality.¶
Scenario: Sender publishes video live streaming with two Tracks: 1080p (3Mbps) and 720p (1.5Mbps). Receiver is currently subscribed to the 1080p Track.¶
Trigger condition: Available network bandwidth drops from 4Mbps to 2Mbps.¶
MMF signals: Proportion of Objects Received Late increases (video frames arrive but exceed deadline), PLAYOUT_AHEAD_MS gradually decreases.¶
CC response: BBR reduces pacing_rate to match new bandwidth.¶
Application-layer response: MoQ publishing layer detects persistently high Objects Received Late on the 1080p Track, triggers ABR switching: switches to 720p Track at the next Group boundary (native MoQ Track switching mechanism).¶
Recovery: After MMF reports Objects Received Late returning to normal and PLAYOUT_AHEAD_MS recovering, sender may attempt to switch back to 1080p.¶
Benefit: Per-frame integrity and deadline information provided by MMF enables higher ABR decision accuracy than pure CC-driven approaches.¶
Trigger condition: Available bandwidth drops sharply.¶
MMF signals: Objects Lost increases, Avg Inter-Arrival Delta increases, PLAYOUT_AHEAD_MS decreases.¶
CC response: MoQ layer issues pacing_gain=1.0 based on MMF loss signal, pauses upward probing.¶
Application-layer response: Reduce Opus bitrate, pause video Track (prioritize audio).¶
Benefit: Peer-side frame loss signal from MMF and congestion signal from BBR local ACK can cross-validate. Gradually restore bitrate after network recovery.¶
Trigger condition: Persistent congestion.¶
MMF signals: Objects Lost persistently high, PLAYOUT_AHEAD_MS at low level.¶
CC response: MoQ layer continuously issues low pacing_gain, pauses upward probing.¶
Application-layer response: Based on general adaptation from Use Case B, inference pipeline reduces chunk_size, accelerates audio flush, reduces output latency. CC and application layer adjust synchronously.¶
Benefit: Per-frame level adaptation takes effect within frame cycle; audio remains uninterrupted throughout. During recovery, gradually restore chunk_size and bitrate.¶
Trigger condition: Inference model suddenly generates long response, audio_response traffic spikes.¶
MMF signals: High proportion of Objects Received Late (frames arrive but exceed playback deadline), Avg Inter-Arrival Delta is large.¶
CC response: Reduce pacing_rate.¶
Application-layer response: Reduce encoding bitrate, accelerate flush, guide inference to generate more concise responses (reduce audio duration at the source).¶
Benefit: Trade quality for timeliness, avoid playback stuttering.¶
Trigger condition: Uplink network jitter (streaming input inference scenario).¶
MMF signals: Input MMF reports high proportion of NOT_RECEIVED.¶
Application-layer response:¶
Benefit: Bidirectional MMF coordinates quality of both uplink and downlink paths. MMF session activity signals (feedback frequency, PLAYOUT_AHEAD_MS) can be used for KV cache eviction and priority decisions.¶
This document defines the following code points for registration:¶
The authors would like to thank Cullen Jennings for his valuable review comments, proposed revisions, and insightful suggestions on application scenarios for this document.¶