Crate moq 

C bindings for moq_net.

Provides a C-compatible API for real-time pub/sub over QUIC.

Concepts

• Session: Network connection to a MoQ relay
• Origin: Collection of broadcasts
• Broadcast: Container for tracks
• Track: Named stream of groups
• Group: Collection of frames
• Frame: Sized payload with timestamp

Error Handling

All functions return negative error codes on failure or non-negative values on success. Resources are managed through opaque integer handles that must be explicitly closed.

Structs

Audio

Id

Opaque resource identifier returned to C code.

Video

Raw-video consume state: decoder tasks plus their buffered decoded frames.

moq_announced

Information about a broadcast announced by an origin.

moq_audio_config

Information about an audio rendition in the catalog.

moq_audio_decoder_output

PCM layout the caller wants out of moq_consume_audio_raw.

moq_audio_encoder_input

PCM layout the caller hands to moq_publish_audio_raw_frame.

moq_audio_encoder_output

Codec-side configuration. sample_rate / channels = 0 means “match the input (snapping the rate up to a libopus-supported value if necessary)”.

moq_audio_frame

One audio frame: payload bytes plus a presentation timestamp.

moq_connection_stats

A snapshot of connection statistics, filled in by moq_session_stats.

moq_datagram

A best-effort raw track datagram delivered via moq_consume_datagrams.

moq_frame

Information about a frame of media.

moq_json_snapshot_config

Options for a JSON snapshot track (lossy latest-value mode).

moq_json_stream_config

Options for a JSON stream track (lossless append-log mode).

moq_json_value

A JSON value delivered by a consumer callback.

moq_section

One untyped application catalog section: a name and its JSON value.

moq_string

A borrowed UTF-8 string slice, NOT NULL terminated.

moq_subscription

Subscriber-side raw track delivery preferences.

moq_track_info

Publisher-side raw track properties.

moq_video_config

Information about a video rendition in the catalog.

moq_video_decoder_output

Decode-side configuration the caller passes to moq_consume_video_raw.

moq_video_frame

One decoded video frame: packed I420 plus a presentation timestamp.

moq_video_properties

Catalog properties shared by every video rendition.

Enums

Error

Error types that can occur in the FFI layer.

moq_audio_format

Raw PCM sample layout, mirroring WebCodecs AudioData.format.

Functions

moq_consume_audio^⚠

Consume an audio track from a broadcast, emitting the frames in order.

moq_consume_audio_close

Stop an audio track consumer’s background task.

moq_consume_audio_config^⚠

Query information about an audio track in a catalog.

moq_consume_audio_raw^⚠

Subscribe to an audio track and decode it into PCM.

moq_consume_audio_raw_close

Stop an audio (raw PCM) consumer’s background task.

moq_consume_audio_raw_frame^⚠

Copy a delivered frame’s metadata into dst.

moq_consume_audio_raw_frame_free

Free a frame previously delivered through the consume callback. Required for every delivered frame ID; closing the parent consumer is not enough.

moq_consume_catalog^⚠

Create a catalog consumer for a broadcast.

moq_consume_catalog_close

Stop a catalog consumer’s background subscription.

moq_consume_catalog_free

Free a catalog snapshot received via the moq_consume_catalog callback.

moq_consume_catalog_section^⚠

Look up an application catalog section by name.

moq_consume_catalog_section_at^⚠

Query an application catalog section by index, keyed by name.

moq_consume_catalog_section_count

Number of untyped application catalog sections in a catalog snapshot.

moq_consume_close

Close a broadcast consumer and clean up its resources.

moq_consume_datagram^⚠

Read a datagram delivered via the moq_consume_datagrams callback.

moq_consume_datagram_free

Free a datagram delivered via the moq_consume_datagrams callback, releasing its payload.

moq_consume_datagrams^⚠

Subscribe to a raw track’s best-effort datagrams by name.

moq_consume_datagrams_close

Stop a datagram subscription’s background task.

moq_consume_frame^⚠

Get a chunk of a frame’s payload.

moq_consume_frame_free

Free a decoded frame delivered via a moq_consume_video or moq_consume_audio callback.

moq_consume_json_close

Stop a JSON consumer’s background task (snapshot or stream).

moq_consume_json_snapshot^⚠

Subscribe to a JSON snapshot track (lossy latest-value) by name.

moq_consume_json_stream^⚠

Subscribe to a JSON stream track (lossless append-log) by name.

moq_consume_json_value^⚠

Read a JSON value delivered via a moq_consume_json_snapshot or moq_consume_json_stream callback.

moq_consume_json_value_free

Release a JSON value delivered via a consumer callback.

moq_consume_track^⚠

Subscribe to a raw track by name, delivering each frame’s payload as-is.

moq_consume_track_close

Stop a raw track consumer’s background task.

moq_consume_track_frame^⚠

Read a raw frame’s payload delivered via the moq_consume_track callback.

moq_consume_track_frame_free

Free a raw frame delivered via the moq_consume_track callback, releasing its payload.

moq_consume_track_update^⚠

Update a raw track subscription’s delivery preferences.

moq_consume_video^⚠

Consume a video track from a broadcast, delivering frames in order.

moq_consume_video_close

Stop a video track consumer’s background task.

moq_consume_video_config^⚠

Query information about a video track in a catalog.

moq_consume_video_properties^⚠

Query the catalog properties shared by every video rendition.

moq_consume_video_raw^⚠

Subscribe to a video track and decode it into raw I420 frames.

moq_consume_video_raw_close

Stop a video (raw) consumer’s background task.

moq_consume_video_raw_frame^⚠

Copy a delivered frame’s metadata into dst.

moq_consume_video_raw_frame_free

Free a frame previously delivered through the consume callback. Required for every delivered frame id; closing the parent consumer is not enough.

moq_error

Human-readable reason for the most recent failed call on the calling thread.

moq_log_level^⚠

Initialize the library with a log level.

moq_origin_announced^⚠

Learn about all broadcasts published to an origin.

moq_origin_announced_close

Stop receiving announcements for broadcasts published to an origin.

moq_origin_announced_free

Free a single announcement delivered to a moq_origin_announced on_announce callback.

moq_origin_announced_info^⚠

Query information about a broadcast discovered by moq_origin_announced.

moq_origin_close

Close an origin and clean up its resources.

moq_origin_consume_announced^⚠

Consume a broadcast from an origin by path, waiting until it is announced.

moq_origin_consume_announced_close

Abort a wait started by moq_origin_consume_announced.

moq_origin_create

Create an origin for publishing broadcasts.

moq_origin_publish^⚠

Create a broadcast at path on an origin, for publishing media tracks.

moq_origin_request^⚠

Request a broadcast from an origin by path, resolving as soon as it can be served.

moq_origin_request_close

Abort a request started by moq_origin_request.

moq_publish_audio_config^⚠

Add or replace an audio rendition in a broadcast’s catalog.

moq_publish_audio_raw^⚠

Open an audio track on a broadcast.

moq_publish_audio_raw_finish

Flush any pending samples and finalize an audio producer.

moq_publish_audio_raw_frame^⚠

Push one audio frame.

moq_publish_audio_remove^⚠

Remove an audio rendition from a broadcast’s catalog by name.

moq_publish_catalog_section^⚠

Set (or replace) a top-level application catalog section by name.

moq_publish_catalog_section_remove^⚠

Remove a top-level application catalog section by name.

moq_publish_finish

Finish a broadcast and release it, ending its catalog cleanly.

moq_publish_group_abort

Abort a raw group with an application error code.

moq_publish_group_finish

Finish a raw group. No more frames can be written.

moq_publish_group_frame^⚠

Write a frame into a raw group created by moq_publish_track_group.

moq_publish_json_snapshot^⚠

Create a JSON snapshot track (lossy latest-value) on a broadcast.

moq_publish_json_snapshot_finish

Finish a JSON snapshot track. No more values can be published.

moq_publish_json_snapshot_update^⚠

Publish a new value to a JSON snapshot track. value is a UTF-8 JSON document. A no-op if unchanged from the previous update.

moq_publish_json_stream^⚠

Create a JSON stream track (lossless append-log) on a broadcast.

moq_publish_json_stream_append^⚠

Append one record to a JSON stream track. value is a UTF-8 JSON document.

moq_publish_json_stream_finish

Finish a JSON stream track. No more records can be appended.

moq_publish_media^⚠

Create a new media track for a broadcast

moq_publish_media_finish

Finish a media track, flushing any buffered frames. No more frames can be written.

moq_publish_media_frame^⚠

Write data to a track.

moq_publish_set_announce

Set whether a broadcast created by moq_origin_publish is live: announced by its origin.

moq_publish_track^⚠

Create a raw track on a broadcast for arbitrary byte payloads.

moq_publish_track_abort

Abort a raw track with an application error code.

moq_publish_track_datagram^⚠

Send a best-effort datagram on a raw track created by moq_publish_track.

moq_publish_track_finish

Finish a raw track. No more groups or frames can be written.

moq_publish_track_finish_at

Declare a raw track’s exclusive final group sequence.

moq_publish_track_frame^⚠

Write a single-frame group to a raw track with a timestamp.

moq_publish_track_group

Append a new group to a raw track, returning a group producer.

moq_publish_track_group_at

Create a raw group with an explicit sequence number.

moq_publish_video_config^⚠

Add or replace a video rendition in a broadcast’s catalog.

moq_publish_video_properties^⚠

Replace the catalog properties shared by every video rendition.

moq_publish_video_remove^⚠

Remove a video rendition from a broadcast’s catalog by name.

moq_session_close

Request that a session shut down.

moq_session_connect^⚠

Start establishing a connection to a MoQ server.

moq_session_stats^⚠

Snapshot the current connection statistics for a session.

Type Aliases

Status

Status code returned by FFI functions.