Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
32 commits
Select commit Hold shift + click to select a range
87c19b1
chore(quest): claim quest/m2/probe/viewer-target.md
kixelated Oct 28, 2026
0158e79
feat(net): viewer probe targets and receive grants
kixelated Oct 28, 2026
edc77a4
chore(quest): finish viewer targets
kixelated Oct 28, 2026
52354fb
docs(net): the client advertises Increase with a sender
kixelated Oct 28, 2026
161c9c6
Merge remote-tracking branch 'origin/main' into quest/m2/probe/viewer…
kixelated Oct 31, 2026
b10c63c
feat(ffi): viewers divide the receive estimate
kixelated Oct 31, 2026
5bf755c
feat(moq-c): viewers in the C ABI
kixelated Oct 31, 2026
4beec47
feat(bindings): carry viewers through every binding
kixelated Oct 31, 2026
cfb197d
chore(quest): players name the FFI viewer handles
kixelated Oct 31, 2026
37814ed
fix(moq-c): box the session task's inner future
kixelated Oct 31, 2026
ad189e4
fix(net): keep a newer PROBE stream's target, coalesce blocked targets
kixelated Oct 31, 2026
165fa95
fix(net): ignore a superseded PROBE stream's late targets
kixelated Oct 31, 2026
116a553
fix(net): follow the newest target among open PROBE streams
kixelated Oct 31, 2026
b6eb137
Merge remote-tracking branch 'origin/main' into quest/m2/probe/viewer…
kixelated Oct 31, 2026
a25f126
style(net): format the viewer demand test
kixelated Oct 31, 2026
25daac0
fix(net): address PR review on viewers and PROBE targets
kixelated Oct 31, 2026
2d56e9f
Merge remote-tracking branch 'origin/main' into pr-7090
kixelated Oct 31, 2026
d2aa171
Merge base and reconcile viewer tests with native-only kio APIs
Nov 1, 2026
01f09da
Merge base and preserve viewer PROBE documentation alongside epoch re…
Nov 1, 2026
d48b850
Merge origin/main into quest/m2/probe/viewer-target
kixelated Nov 1, 2026
217e617
fix(net): reset a stalled PROBE target write when the probe ends
kixelated Nov 1, 2026
9590812
Merge remote-tracking branch 'origin/main' into iterate-7090
kixelated Nov 2, 2026
d773901
Merge remote-tracking branch 'origin/main' into iterate-7090
kixelated Nov 2, 2026
578a2dd
Merge main and preserve cached viewer grant allocation
kixelated Nov 2, 2026
73d02db
Merge main into viewer probe targets
kixelated Nov 4, 2026
4a4e510
feat(net): bound viewer probe targets; local override covers local re…
kixelated Nov 4, 2026
d862400
quest: record the 2026-11-03 viewer-target decisions; unblock the fol…
kixelated Nov 4, 2026
36980cb
style: rustfmt the viewer limit changes
kixelated Nov 4, 2026
246e792
fix(net): a closed JS viewers registry retracts its target override
kixelated Nov 4, 2026
5652b94
Merge main into viewer probe targets
kixelated Nov 4, 2026
219e46c
fix(signals): a Derived's one-shot reader re-arms before its sources …
kixelated Nov 4, 2026
ec29400
Merge main into viewer probe targets
kixelated Nov 4, 2026
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
4 changes: 4 additions & 0 deletions c/moq/MIGRATE.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,10 @@ How to update your code for each breaking change, newest first.

## Unreleased

### Viewer targets are bounded ([#7090](https://github.com/moq-dev/moq/pull/7090))

Viewer ceilings and PROBE target overrides are refused with the new `MOQ_ERROR_OUT_OF_RANGE` once they would sum above 2^53 - 1 bps, the most a PROBE target carries; nothing changes on a refusal. `moq_viewers_watch`, `moq_viewers_set_target`, and `moq_viewer_update` return it. Handle the new variant wherever you match the error exhaustively. Regenerate bindings and rebuild the matching native library together.

### Media setup refusals are typed

Audio and video subscribe setup now reports `MOQ_ERROR_UNSUPPORTED_CONFIG` when the decoder refuses a codec, layout, or description. Handle this variant to try another rendition instead of inspecting an audio/video error message or `Unsupported`. Decoder faults, such as a backend that fails to open, and later peer and decode failures keep their existing errors. Regenerate bindings and rebuild the matching native library together.
Expand Down
4 changes: 4 additions & 0 deletions cpp/moq/MIGRATE.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,10 @@

## Unreleased

### Viewer targets are bounded ([#7090](https://github.com/moq-dev/moq/pull/7090))

Viewer ceilings and PROBE target overrides are refused with the new `moq::Error::kOutOfRange` once they would sum above 2^53 - 1 bps, the most a PROBE target carries; nothing changes on a refusal. `Viewers::watch` and `set_target` and `Viewer::update` return a `moq::expected` carrying it. Handle the new variant wherever you match the error exhaustively. Regenerate bindings and rebuild the matching native library together.

### `moq::VideoInit::lower` takes either producer kind ([#7699](https://github.com/moq-dev/moq/pull/7699))

`lower` is `std::optional<moq::MediaProducer>` instead of a `std::shared_ptr<moq::MediaTrackProducer>`. Assign `moq::MediaProducer(moq::MediaProducer::kTrack{producer})`, or `kStream` for a `moq::MediaTrackStreamProducer`.
Expand Down
4 changes: 4 additions & 0 deletions dart/moq/MIGRATE.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,10 @@ How to update your code for each breaking change, newest first.

## Unreleased

### Viewer targets are bounded ([#7090](https://github.com/moq-dev/moq/pull/7090))

Viewer ceilings and PROBE target overrides are refused with the new `OutOfRangeMoqException` once they would sum above 2^53 - 1 bps, the most a PROBE target carries; nothing changes on a refusal. `Viewers.watch` and `setTarget` and `Viewer.update` throw it. Handle the new variant wherever you match the error exhaustively. Regenerate bindings and rebuild the matching native library together.

### `VideoInit.lower` takes either producer kind ([#7699](https://github.com/moq-dev/moq/pull/7699))

`VideoInit.lower` is a `Producer` (`MoqMediaProducer`) instead of a `TrackProducer`. Pass `TrackMoqMediaProducer(producer: ...)`, or `StreamMoqMediaProducer(producer: ...)` for a byte-stream rendition.
Expand Down
7 changes: 7 additions & 0 deletions dart/moq/lib/src/aliases.dart
Original file line number Diff line number Diff line change
Expand Up @@ -198,6 +198,13 @@ typedef BandwidthConsumer = MoqBandwidthConsumer;
/// One track's standing claim on an [Allocator].
typedef Reservation = MoqReservation;

/// Divides one connection's receive estimate among the broadcasts watched over it.
typedef Viewers = MoqViewers;

/// One watched broadcast's standing claim on [Viewers]; holding it requests
/// PROBE, disposing it releases the claim.
typedef Viewer = MoqViewer;

/// Turns a [Reservation]'s grant into a sender's [RateTarget]; call `update` on every frame.
typedef RateControl = MoqRateControl;

Expand Down
10 changes: 10 additions & 0 deletions dart/moq/lib/src/client.dart
Original file line number Diff line number Diff line change
Expand Up @@ -247,6 +247,16 @@ final class Moq {
/// the room back.
Allocator allocator() => session.allocator();

/// The session's viewers, dividing the connection's receive estimate among
/// the broadcasts watched over it.
///
/// Every call returns a handle to the same registry, and the session sends
/// what its viewers' ceilings add up to as its PROBE target. [Viewers.watch]
/// a broadcast with the ceiling of the largest rendition the player would
/// switch to, read its slice with [Viewer.rate], and dispose the [Viewer]
/// once the broadcast stops being watched.
Viewers viewers() => session.viewers();

/// Follow the grant the peer gave this session.
///
/// Listen to [GrantConsumerUpdates.updates] for the current grant and each
Expand Down
16 changes: 16 additions & 0 deletions dart/moq/test/moq_test.dart
Original file line number Diff line number Diff line change
Expand Up @@ -221,6 +221,22 @@ void main() {
final serverSession = await accepted;
expect(client.allocator(), isA<MoqAllocator>());

final viewers = client.viewers();
expect(viewers, isA<Viewers>());
final viewer = viewers.watch(maxBps: 4000000);
expect(viewer, isA<Viewer>());
// A slice never exceeds its ceiling, whether or not QUIC has an estimate yet.
viewer.update(maxBps: 1000000);
expect(viewer.rate() ?? 0, lessThanOrEqualTo(1000000));
viewers.setTarget(targetBps: 0);
viewers.setTarget(targetBps: null);
// Past what a PROBE target carries: refused.
expect(
() => viewers.watch(maxBps: 1 << 53),
throwsA(isA<OutOfRangeMoqException>()),
);
viewer.dispose();

final announcement = client.announced().updates().firstWhere(
(event) => event is AnnounceEventStart,
);
Expand Down
4 changes: 4 additions & 0 deletions dart/moq_ffi/MIGRATE.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,10 @@

## Unreleased

### Viewer targets are bounded ([#7090](https://github.com/moq-dev/moq/pull/7090))

Viewer ceilings and PROBE target overrides are refused with the new `OutOfRangeMoqException` once they would sum above 2^53 - 1 bps, the most a PROBE target carries; nothing changes on a refusal. `MoqViewers.watch` and `setTarget` and `MoqViewer.update` throw it. Handle the new variant wherever you match the error exhaustively. Regenerate bindings and rebuild the matching native library together.

### Media setup refusals are typed

Audio and video subscribe setup now reports `UnsupportedConfigMoqException` when the decoder refuses a codec, layout, or description. Handle this variant to try another rendition instead of inspecting an audio/video error message or `Unsupported`. Decoder faults, such as a backend that fails to open, and later peer and decode failures keep their existing errors. Regenerate bindings and rebuild the matching native library together.
Expand Down
Loading
Loading