ARG mux proposal #30
ARG mux proposal #30
Conversation
* Create substream_constraints.json * Update constraint_set.json - to include the new substreams property * Update Examples.md - to add MUX example using substreams * Update APIs/schemas/substream_constraints.json to an "open enum" Co-authored-by: Gareth Sylvester-Bradley <31761158+garethsb@users.noreply.github.com> * Update Examples.md in line with the latest schema update for "format" * Update Receiver Capabilities.md To add substreams section * Change "MUX" to "mux" --------- Co-authored-by: Gareth Sylvester-Bradley <31761158+garethsb@users.noreply.github.com>
to include better descriptions
| @@ -20,6 +20,13 @@ | |||
| "description": "This value indicates whether a Constraint Set is available to use immediately (true) or whether this is an offline capability which can be activated via some unspecified configuration mechanism (false). When the attribute is omitted its value is assumed to be true.", | |||
| "type": "boolean", | |||
| "default": true | |||
| }, | |||
| "urn:x-nmos:substreams": { | |||
There was a problem hiding this comment.
We've discussed that in order to maintain BCP-004-01 v1.0 compatibility this cannot be urn:x-nmos:cap:substreams because of the pattern property below. But not clear whether urn:x-nmos:substreams name is precise enough.
| { | ||
| "$schema": "http://json-schema.org/draft-04/schema#", | ||
| "description": "Describes substream constraints", | ||
| "title": "Constraint Set", |
There was a problem hiding this comment.
| "title": "Constraint Set", | |
| "title": "Substream Constraints", |
| "type": "object", | ||
| "minProperties": 1, | ||
| "properties": { | ||
| "description": { |
There was a problem hiding this comment.
Each constraint set uses URN attribute names, since the parameter constraints in each set are intended to be extensible, and the metadata attributes therefore also have URNs, like urn:x-nmos:cap:meta:label.
Here it probably does make sense to use "simple" attribute names, like format and count (or minimum tbc). Should this one be description or label?
| "count": { | ||
| "$ref": "param_constraint_number.json" | ||
| }, |
There was a problem hiding this comment.
We've discussed that most/all mux Receivers are capable of discarding substreams they are not interested in. Therefore we started discussing whether a minimum attribute could be simpler and sufficient?
E.g. something like
| "count": { | |
| "$ref": "param_constraint_number.json" | |
| }, | |
| "minimum": { | |
| "type": "integer", | |
| "default": 1, | |
| "minimum": 0 | |
| }, |
No description provided.