§8.29.

SUBSCRIBE_ANNOUNCES_ERROR

A publisher sends a SUBSCRIBE_ANNOUNCES_ERROR control message in response to a failed SUBSCRIBE_ANNOUNCES.

SUBSCRIBE_ANNOUNCES_ERROR Message {
  Type (i) = 0x13,
  Length (16),
  Request ID (i),
  Error Code (i),
  Error Reason (Reason Phrase)
}
Figure 31: MOQT SUBSCRIBE_ANNOUNCES_ERROR Message
  • Request ID: The Request ID of the SUBSCRIBE_ANNOUNCES this message is replying to Section 8.27.

  • Error Code: Identifies an integer error code for the namespace subscription failure.

  • Error Reason: Provides the reason for the namespace subscription error. See Section 1.3.3.

The application SHOULD use a relevant error code in SUBSCRIBE_ANNOUNCES_ERROR, as defined below:

Table 9
Code Reason
0x0 Internal Error
0x1 Unauthorized
0x2 Timeout
0x3 Not Supported
0x4 Namespace Prefix Unknown
0x5 Namespace Prefix Overlap
0x10 Malformed Auth Token
0x12 Expired Auth Token
  • Internal Error - An implementation specific or generic error occurred.

  • Unauthorized - The subscriber is not authorized to subscribe to the given namespace prefix.

  • Timeout - The operation could not be completed before an implementation specific timeout.

  • Not Supported - The endpoint does not support the SUBSCRIBE_ANNOUNCES method.

  • Namespace Prefix Unknown - The namespace prefix is not available for subscription.

  • Namespace Prefix Overlap - The namespace prefix overlaps with another SUBSCRIBE_ANNOUNCES in the same session.

  • Malformed Auth Token - Invalid Auth Token serialization during registration (see Section 8.2.1.1).

  • Expired Auth Token - Authorization token has expired Section 8.2.1.1).

This is one section of the MoQT specification, rendered per-section for quick reference and citation. The authoritative text is draft-ietf-moq-transport-12 at the IETF.