Result and error codes for the IVS Linux Broadcast SDK. OK (0) means success. Existing values never change meaning. Undocumented codes may be observed at runtime (SDK-internal errors); treat an unknown code as an internal error.
| Enumerator |
|---|
| AWS_IVS_REALTIME_ERROR_CODE_OK | Success.
|
| AWS_IVS_REALTIME_ERROR_CODE_SOCKET_CREATION_FAILED | Network connection failed during initialization due to system resource constraints. Verify network availability and retry the stream.
|
| AWS_IVS_REALTIME_ERROR_CODE_SOCKET_CONFIGURATION_FAILED | Network connection setup failed due to configuration issues. Check network connectivity and retry the stream.
|
| AWS_IVS_REALTIME_ERROR_CODE_SOCKET_CONNECT_FAILED | Unable to establish network connection to the streaming server. Verify network connectivity and that the stream URL is accessible.
|
| AWS_IVS_REALTIME_ERROR_CODE_SOCKET_SEND_FAILED | Failed to send data over the network connection. Check network stability and restart the stream.
|
| AWS_IVS_REALTIME_ERROR_CODE_SOCKET_RECV_FAILED | Failed to receive data from the streaming server. Check network stability and restart the stream.
|
| AWS_IVS_REALTIME_ERROR_CODE_SOCKET_RECV_FAILED_EOF | The streaming server closed the connection unexpectedly. Verify no other users are streaming to this endpoint and restart the stream.
|
| AWS_IVS_REALTIME_ERROR_CODE_SOCKET_REMOTE_HANGUP | Network connection closed unexpectedly during stream playback. Check network stability and restart the stream.
|
| AWS_IVS_REALTIME_ERROR_CODE_SOCKET_REMOTE_ERROR | Network error occurred during stream playback. Verify network connectivity and restart the stream.
|
| AWS_IVS_REALTIME_ERROR_CODE_SOCKET_GET_RTT_FAILED_NOT_SUPPORTED_ON_THIS_SYSTEM | Network latency measurement is unavailable on this device. Streaming will continue without latency metrics.
|
| AWS_IVS_REALTIME_ERROR_CODE_SOCKET_SEND_LOW_WATER_FAILED | Network send buffer configuration failed. Check network conditions and retry the stream.
|
| AWS_IVS_REALTIME_ERROR_CODE_COULD_NOT_RESOLVE_ADDRESS | Unable to resolve the streaming server hostname. Check network connectivity and verify the stream URL is correct.
|
| AWS_IVS_REALTIME_ERROR_CODE_SOCKET_GET_RTT_FAILED_NOT_CONNECTED | Network latency measurement was requested while no network connection was established. Latency metrics are unavailable until the connection is restored.
|
| AWS_IVS_REALTIME_ERROR_CODE_GET_AVERAGE_OUTGOING_RATE_FAILED | Network metrics calculation failed due to invalid configuration. This is an internal error that should not affect streaming, but calculated transmission statistics may be impacted.
|
| AWS_IVS_REALTIME_ERROR_CODE_GET_ESTIMATED_CONGESTION_LEVEL_FAILED | Network congestion measurement failed due to invalid configuration. This is an internal error that should not affect streaming, but calculated transmission statistics may be impacted.
|
| AWS_IVS_REALTIME_ERROR_CODE_TLS_SEND_FAILED_BAD_WRITE_RETRY | Secure connection data transmission failed due to protocol violation. Restart the stream to re-establish the connection.
|
| AWS_IVS_REALTIME_ERROR_CODE_TLS_SEND_FAILED_ATTEMPTED_TO_SEND_WHILE_HANDSHAKING | Data transmission attempted before secure connection was established. Restart the stream.
|
| AWS_IVS_REALTIME_ERROR_CODE_TLS_SEND_FAILED_ATTEMPTED_TO_SEND_WHILE_DISCONNECTED | Data transmission attempted after connection was closed. Restart the stream to re-establish the connection.
|
| AWS_IVS_REALTIME_ERROR_CODE_TLS_RECV_FAILED_ATTEMPTED_TO_RECV_WHILE_HANDSHAKING | Data reception attempted before secure connection was established. Restart the stream.
|
| AWS_IVS_REALTIME_ERROR_CODE_TLS_RECV_FAILED_ATTEMPTED_TO_RECV_WHILE_DISCONNECTED | Data reception attempted after connection was closed. Restart the stream to re-establish the connection.
|
| AWS_IVS_REALTIME_ERROR_CODE_TLS_RECV_FAILED_ATTEMPTED_TO_RECV_AFTER_RECEIVING_SHUTDOWN_FROM_PEER | The streaming server closed the connection. Verify no other users are streaming to this endpoint and restart the stream.
|
| AWS_IVS_REALTIME_ERROR_CODE_TLS_RECV_FAILED_ATTEMPTED_TO_RECV_WHILE_SHUTTING_DOWN | Data reception attempted while connection is closing. This is expected during stream shutdown.
|
| AWS_IVS_REALTIME_ERROR_CODE_TLS_HANDSHAKE_FAILED_COULD_NOT_CREATE_SSL_INSTANCE | Secure connection initialization failed. This is usually an allocation failure, the device may not be able to allocate more memory to the process.
|
| AWS_IVS_REALTIME_ERROR_CODE_TLS_SEND_FAILED_OPEN_SSL_ERROR | Failed to send data over secure connection. Check network stability and restart the stream. This could also be caused by a firewall restricting access to the provided domain.
|
| AWS_IVS_REALTIME_ERROR_CODE_TLS_RECV_FAILED_OPEN_SSL_ERROR | Failed to receive data over secure connection. Check network stability and restart the stream.
|
| AWS_IVS_REALTIME_ERROR_CODE_TLS_HANDSHAKE_FAILED_OPEN_SSL_ERROR | Secure connection handshake failed. Verify network connectivity and restart the stream. This could also be caused by a firewall restricting access to the provided domain.
|
| AWS_IVS_REALTIME_ERROR_CODE_TLS_FAILED_TO_GET_X509_PARAM | Certificate verification setup failed during secure connection. Restart the stream to retry the connection. This could also be caused by a firewall restricting access to the provided domain.
|
| AWS_IVS_REALTIME_ERROR_CODE_TLS_SET_SNI_FAILED | Server hostname configuration failed during secure connection setup. Verify the stream URL and restart the stream. This could also be caused by a firewall restricting access to the provided domain.
|
| AWS_IVS_REALTIME_ERROR_CODE_TLS_SET_EXPECTED_HOST_FAILED | Certificate hostname verification setup failed. Verify the stream URL is correct and restart the stream. This could also be caused by a firewall restricting access to the provided domain.
|
| AWS_IVS_REALTIME_ERROR_CODE_TLS_HANDSHAKE_TIMEOUT | The secure connection handshake timed out. The server accepted the connection but did not complete the TLS negotiation. Verify that the endpoint expects a secure connection and check network connectivity.
|
| AWS_IVS_REALTIME_ERROR_CODE_EVENT_LOOP_FAILED_TO_CREATE_TIMER | Internal timing mechanism failed. This may prevent efficient DNS resolution.
|
| AWS_IVS_REALTIME_ERROR_CODE_WEB_SOCKET_HANDSHAKE_INVALID_UPGRADE_RESPONSE | Server did not accept WebSocket connection request.
|
| AWS_IVS_REALTIME_ERROR_CODE_WEB_SOCKET_HANDSHAKE_INVALID_ACCEPT_KEY | WebSocket handshake validation failed.
|
| AWS_IVS_REALTIME_ERROR_CODE_WEB_SOCKET_HANDSHAKE_PROTOCOL_NEGOTIATION_FAILED | Server selected a WebSocket protocol not supported by the client. Verify the events URL is correct and restart the session.
|
| AWS_IVS_REALTIME_ERROR_CODE_WEB_SOCKET_HANDSHAKE_TIMEOUT | WebSocket connection took too long to establish. Check network connectivity and retry the connection.
|
| AWS_IVS_REALTIME_ERROR_CODE_WEB_SOCKET_HANDSHAKE_INVALID_STATUS_CODE | Server rejected WebSocket connection with unexpected status code. Verify the events URL supports WebSocket connections.
|
| AWS_IVS_REALTIME_ERROR_CODE_WEB_SOCKET_HANDSHAKE_INVALID_HEADERS | Server response headers do not meet WebSocket protocol requirements. Verify the events URL is correct and supports WebSocket.
|
| AWS_IVS_REALTIME_ERROR_CODE_WEB_SOCKET_FRAME_INVALID_OPCODE | Received malformed data from the streaming server. Restart the session to re-establish the connection.
|
| AWS_IVS_REALTIME_ERROR_CODE_WEB_SOCKET_FRAME_INVALID_LENGTH | Received data with invalid length from the streaming server. Restart the connection to re-establish the connection.
|
| AWS_IVS_REALTIME_ERROR_CODE_WEB_SOCKET_FRAME_INVALID_MASK | Server violated WebSocket protocol by sending masked data. Restart the session to re-establish the connection.
|
| AWS_IVS_REALTIME_ERROR_CODE_WEB_SOCKET_FRAME_CONTROL_FRAME_TOO_LARGE | Server sent control message exceeding protocol limit. Restart the session to re-establish the connection.
|
| AWS_IVS_REALTIME_ERROR_CODE_WEB_SOCKET_FRAME_INVALID_UTF8 | Received text message with invalid character encoding from the server. Restart the session to re-establish the connection.
|
| AWS_IVS_REALTIME_ERROR_CODE_WEB_SOCKET_FRAME_RESERVED_BITS_SET | Server violated WebSocket protocol by setting reserved bits. Restart the session to re-establish the connection.
|
| AWS_IVS_REALTIME_ERROR_CODE_WEB_SOCKET_FRAME_INCOMPLETE_DATA | Received partial data from the streaming server. This is typically handled automatically by waiting for more data and should not impact the session.
|
| AWS_IVS_REALTIME_ERROR_CODE_WEB_SOCKET_FRAME_CONTROL_FRAME_FRAGMENTED | Server violated WebSocket protocol by fragmenting a control message. Restart the session to re-establish the connection.
|
| AWS_IVS_REALTIME_ERROR_CODE_WEB_SOCKET_PROTOCOL_MESSAGE_TOO_LARGE | Received message exceeds maximum allowed size. Restart the session to re- establish the connection.
|
| AWS_IVS_REALTIME_ERROR_CODE_WEB_SOCKET_PROTOCOL_CONNECTION_NOT_ESTABLISHED | Attempted to send data before WebSocket connection was ready. This is an internal SDK and the session should be retried.
|
| AWS_IVS_REALTIME_ERROR_CODE_WEB_SOCKET_CONNECTION_TIMEOUT | WebSocket connection took too long to establish. Check network connectivity and restart the session.
|
| AWS_IVS_REALTIME_ERROR_CODE_WEB_SOCKET_CONNECTION_LOST | The streaming server closed the WebSocket connection. Check network connectivity and restart the session.
|
| AWS_IVS_REALTIME_ERROR_CODE_WEB_SOCKET_CONNECTION_CLOSE_TIMEOUT | Server did not acknowledge connection close request in time. The connection will be terminated forcefully.
|
| AWS_IVS_REALTIME_ERROR_CODE_WEB_SOCKET_CONNECTION_PONG_TIMEOUT | The client sent a WebSocket PING on the idle WebSocket but no PONG was received within the timeout period. It is likely the socket has disconnected but hasn't yet reached the TCP idle timeout. The WebSocket will automatically attempt to reconnect.
|
| AWS_IVS_REALTIME_ERROR_CODE_STAGE_INVALID_TOKEN | Stage token is invalid or malformed. Generate a new token and create a new stage session.
|
| AWS_IVS_REALTIME_ERROR_CODE_STAGE_EXPIRED_TOKEN | Stage token has expired. Generate a new token and create a new stage session.
|
| AWS_IVS_REALTIME_ERROR_CODE_NO_SESSION | Cannot perform operation because no active stage session exists. Join a stage before attempting this operation.
|
| AWS_IVS_REALTIME_ERROR_CODE_ALREADY_JOINING_STAGE | Cannot join stage because a join operation is already in progress or completed. Wait for the current operation to finish.
|
| AWS_IVS_REALTIME_ERROR_CODE_STAGE_NOT_READY | The Stage session is not ready due to a failure is the setup process. Check for errors during initialization, and recreate the local Stage instance.
|
| AWS_IVS_REALTIME_ERROR_CODE_SELF_SUBSCRIBE_NOT_SUPPORT | Cannot subscribe to your own participant stream. Subscribe to other participants instead. This should not be possible using the StageStrategy.
|
| AWS_IVS_REALTIME_ERROR_CODE_NO_PARTICIPANT_TO_SUBSCRIBE_TO | Participant not found in the stage. This is likely because the remote participant unpublished at the same time this SDK attempted to subscribe.
|
| AWS_IVS_REALTIME_ERROR_CODE_PUBLISH_FAILED | Failed to publish audio/video to the stage after multiple retry attempts. Check network connectivity and retry.
|
| AWS_IVS_REALTIME_ERROR_CODE_SUBSCRIBE_FAILED | Failed to subscribe to participant stream after multiple retry attempts. Check network connectivity and retry.
|
| AWS_IVS_REALTIME_ERROR_CODE_OFFER_CREATION_FAIL_PUBLISH | Failed to create WebRTC offer for publishing. Retry the publish operation.
|
| AWS_IVS_REALTIME_ERROR_CODE_OFFER_CREATION_FAIL_SUBSCRIBE | Failed to create WebRTC offer for subscribing. Retry the subscribe operation.
|
| AWS_IVS_REALTIME_ERROR_CODE_PUB_SUB_ABORTED | Publish or subscribe operation was cancelled. This is expected when leaving or unsubscribing in the middle of an operation.
|
| AWS_IVS_REALTIME_ERROR_CODE_STAGE_AT_CAPACITY | Stage has reached maximum participant capacity. Wait for a participant to leave or create a new stage.
|
| AWS_IVS_REALTIME_ERROR_CODE_INTERNAL_SERVER_ERROR | An unexpected server error occurred. Retry the operation or contact support if the issue persists.
|
| AWS_IVS_REALTIME_ERROR_CODE_STAGE_TOKEN_REJECTED | Stage token lacks required permissions or has been revoked. Generate a new token with appropriate permissions.
|
| AWS_IVS_REALTIME_ERROR_CODE_STAGE_AUTHENTICATION_ERROR | Stage authentication failed during join operation. The stage may have been deleted or is no longer available.
|
| AWS_IVS_REALTIME_ERROR_CODE_INSUFFICIENT_INPUT_RESOLUTION | Input video resolution does not meet stage requirements. Increase camera resolution or adjust stage configuration.
|
| AWS_IVS_REALTIME_ERROR_CODE_TOKEN_EXCHANGE_INVALID_TOKEN | The token provided to the exchange token API was invalid and couldn't be parsed. Create a new token and try again.
|
| AWS_IVS_REALTIME_ERROR_CODE_TOKEN_EXCHANGE_INCOMPATIBLE_TOKEN | The token provided to the exchange token API was not compatible with the existing Stage. This is likely because properties that must remain constant (jti, topic, etc) had changed.
|
| AWS_IVS_REALTIME_ERROR_CODE_CONNECTION_TOKEN_INVALID | The connection token passed to the IVS RealTimeConnection is invalid or malformed. Generate a new connection token and create a new connection.
|
| AWS_IVS_REALTIME_ERROR_CODE_CONNECTION_TOKEN_EXPIRED | The connection token passed to the IVS RealTimeConnection has expired. Generate a new connection token and create a new connection.
|
| AWS_IVS_REALTIME_ERROR_CODE_MULTIHOST_GROUP_STATE_PIPELINE_MISSING_MULTIHOST_EVENT_BUS | Internal stage event system is not initialized. Restart the stage session.
|
| AWS_IVS_REALTIME_ERROR_CODE_MULTIHOST_GROUP_STATE_PIPELINE_MISSING_EVENT_GENERATOR | Internal event generation system is not initialized. Restart the stage session.
|
| AWS_IVS_REALTIME_ERROR_CODE_RESOURCE_DELETED | Stage or participant resource no longer exists on the server. The stage may have been deleted or the session expired.
|
| AWS_IVS_REALTIME_ERROR_CODE_REMOTE_DISCONNECT_REASON_UNKNOWN | Disconnected from stage by the server for an unspecified reason. Rejoin the stage with a new token if needed.
|
| AWS_IVS_REALTIME_ERROR_CODE_REMOTE_DISCONNECT_STAGE_DELETED | Disconnected because the stage was deleted.
|
| AWS_IVS_REALTIME_ERROR_CODE_REMOTE_DISCONNECT_TOKEN_REUSED | Disconnected because another participant joined with the same token. Use unique tokens for each participant.
|
| AWS_IVS_REALTIME_ERROR_CODE_REMOTE_DISCONNECT_PARTICIPANT_DISCONNECTED | Disconnected from stage by server request. Rejoin the stage with a new token if needed.
|
| AWS_IVS_REALTIME_ERROR_CODE_QUOTA_EXCEEDED | A service-side quota or limit was exceeded. This is a general-purpose error covering multiple quotas; read the error message for the specific limit that was hit and how to resolve it.
|
| AWS_IVS_REALTIME_ERROR_CODE_STAGE_PRESENCE_INCONSISTENT_DELTA | The presence roster became unavailable because the SDK received a presence delta it could not reconcile with the roster it was tracking (for example a participant leaving or being updated when the SDK never saw them join, or joining when they were already present). Because the delta stream can no longer be trusted, the SDK stops applying it and marks the roster unavailable. This is a non-fatal error and does not affect media: publishers still reach the client through the participant/subscribe callbacks. The app is also notified via the consolidated roster callback (Android StageRenderer.onRosterChanged / iOS stage:rosterDidChange:) with an UnavailableError availability; any locally held roster should be cleared and roster UI hidden. The roster recovers if a later valid snapshot arrives.
|
| AWS_IVS_REALTIME_ERROR_CODE_STAGE_PRESENCE_RESYNC_EXHAUSTED | The presence roster became unavailable because the SDK repeatedly could not obtain a usable recovery snapshot (its recovery buffer kept overflowing while awaiting one) and gave up after several attempts. This is a non-fatal error and does not affect media: publishers still reach the client through the participant/subscribe callbacks. The app is also notified via the consolidated roster callback (Android StageRenderer.onRosterChanged / iOS stage:rosterDidChange:) with an UnavailableError availability; any locally held roster should be cleared and roster UI hidden. The roster recovers if a later valid snapshot arrives.
|
| AWS_IVS_REALTIME_ERROR_CODE_STAGE_PRESENCE_SNAPSHOT_REQUEST_TIMEOUT | The presence roster became unavailable because a recovery snapshot request timed out with no server response, and the SDK gave up. This is a non-fatal error and does not affect media: publishers still reach the client through the participant/subscribe callbacks. The app is also notified via the consolidated roster callback (Android StageRenderer.onRosterChanged / iOS stage:rosterDidChange:) with an UnavailableError availability; any locally held roster should be cleared and roster UI hidden. The roster recovers if a later valid snapshot arrives.
|
| AWS_IVS_REALTIME_ERROR_CODE_STAGE_PRESENCE_INCONSISTENT_SNAPSHOT | The presence roster became unavailable because the SDK received a presence snapshot it could not treat as authoritative — it listed the same participant more than once, which should never happen. Because the snapshot cannot be trusted, the SDK discards it and marks the roster unavailable. This is a non-fatal error and does not affect media: publishers still reach the client through the participant/subscribe callbacks. The app is also notified via the consolidated roster callback (Android StageRenderer.onRosterChanged / iOS stage:rosterDidChange:) with an UnavailableError availability; any locally held roster should be cleared and roster UI hidden. The roster recovers if a later valid snapshot arrives.
|
| AWS_IVS_REALTIME_ERROR_CODE_TOKEN_EXCHANGE_INVALID_RESPONSE | Invalid response from the server for a token exchange request. Reconnect to the Stage using the new token, or create a new token and connect again.
|
| AWS_IVS_REALTIME_ERROR_CODE_TOKEN_EXCHANGE_FAILED_RESPONSE | The token exchange request was rejected. The error comment will contain more details. A new token must be created and used to join a new SDK Stage instance.
|
| AWS_IVS_REALTIME_ERROR_CODE_TOKEN_EXCHANGE_TIMEOUT | The token exchange request timed out. Because a token exchange puts the SDK into an in between state of 2 tokens while waiting for confirmation from the backend, a timeout is enforced to prevent undefined behaviors.
|
| AWS_IVS_REALTIME_ERROR_CODE_SIGNALING_RETRY_BUDGET_EXHAUSTED | A request to the IVS service was rate limited repeatedly until timeout exhaustion.
|
| AWS_IVS_REALTIME_ERROR_CODE_EVENTS_RETRIES_EXHAUSTED | Failed to connect to stage after multiple retry attempts. Check network connectivity and retry joining the stage.
|
| AWS_IVS_REALTIME_ERROR_CODE_REAL_TIME_CONNECTION_RELEASED | Cannot perform this operation because the RealTimeConnection provided to the Stage has been released. Keep the RealTimeConnection alive for as long as any Stage that was created with it may be used.
|
| AWS_IVS_REALTIME_ERROR_CODE_PEER_CONNECTION_NETWORK_ERROR | Media connection lost due to network error. Check network connectivity and rejoin the stage.
|
| AWS_IVS_REALTIME_ERROR_CODE_PEER_CONNECTION_SET_REMOTE_DESCRIPTION_FAIL | Failed to establish media connection with participant. Retry the publish or subscribe operation.
|
| AWS_IVS_REALTIME_ERROR_CODE_PEER_CONNECTION_PARSE_REMOTE_DESCRIPTION_ERROR | Received invalid connection data from participant.
|
| AWS_IVS_REALTIME_ERROR_CODE_PEER_CONNECTION_UNEXPECTED_REMOTE_CLOSE | Participant disconnected unexpectedly. The participant may have left the stage or lost network connectivity.
|
| AWS_IVS_REALTIME_ERROR_CODE_PEER_CONNECTION_SET_PARAMETERS_ERROR | Failed to configure video settings for the connection. Check system resources, this may have been a memory allocation failure.
|
| AWS_IVS_REALTIME_ERROR_CODE_PEER_CONNECTION_REQUEST_KEYFRAME_NO_SENDER | Cannot request keyframe because video sender is not ready. Ensure video is being published.
|
| AWS_IVS_REALTIME_ERROR_CODE_PEER_CONNECTION_ADD_TRANSCEIVERS_FAILED | Failed to configure media transceivers for the connection. This is a libWebRTC failure and may indicate the system is low on resources.
|
| AWS_IVS_REALTIME_ERROR_CODE_PEER_CONNECTION_VIDEO_SENDER_NOT_READY | Video sender is not ready for configuration. Ensure video is being published before adjusting settings.
|
| AWS_IVS_REALTIME_ERROR_CODE_PEER_CONNECTION_VIDEO_RTP_PARAMETERS_NOT_READY | Video encoding parameters are not ready. Wait for the connection to fully establish before adjusting video settings.
|
| AWS_IVS_REALTIME_ERROR_CODE_PEER_CONNECTION_SET_VIDEO_RTP_PARAMETERS_FAILED | Failed to update video encoding settings. This is a libWebRTC failure and may indicate the system is low on resources, or the provided configuration is not supported.
|
| AWS_IVS_REALTIME_ERROR_CODE_PEER_CONNECTION_METHOD_NOT_SUPPORTED_ERROR | Connection operation failed due to invalid configuration. The error message will contain more detailed information.
|
| AWS_IVS_REALTIME_ERROR_CODE_PEER_CONNECTION_INIT_FAIL | Failed to initialize media connection. This is a libWebRTC failure and may indicate the system is low on resources. Restat the session to try again.
|
| AWS_IVS_REALTIME_ERROR_CODE_PEER_CONNECTION_NO_MATCHING_MEDIA_TYPE | Operation failed because the requested media type is not available. Ensure audio or video is being published or subscribed before requesting RTC stats.
|
| AWS_IVS_REALTIME_ERROR_CODE_PEER_CONNECTION_TIMED_OUT_CONNECTING | Media connection is taking too long to establish. This operation will be automatically retried, but this may indicate a network connectivity issue.
|
| AWS_IVS_REALTIME_ERROR_CODE_PEER_CONNECTION_ON_FAILURE | WebRTC connection operation failed. This operation will be automatically retried, but this may indicate a network connectivity issue.
|
| AWS_IVS_REALTIME_ERROR_CODE_PEER_CONNECTION_ICE_CONNECTION_FAILED | Media connection failed to establish network path. This operation will be automatically retried, but this may indicate a network connectivity issue.
|
| AWS_IVS_REALTIME_ERROR_CODE_PEER_CONNECTION_CALLBACK_SENDER_NOT_READY | Cannot retrieve video sender configuration because sender is not initialized. Ensure video is being published.
|
| AWS_IVS_REALTIME_ERROR_CODE_PEER_CONNECTION_CALLBACK_RECEIVER_NOT_READY | Cannot retrieve video receiver configuration because receiver is not initialized. Ensure video is being subscribed.
|
| AWS_IVS_REALTIME_ERROR_CODE_NO_VALID_PEER_CONNECTION | Cannot perform operation because media connection is not available. Ensure publish or subscribe is active.
|
| AWS_IVS_REALTIME_ERROR_CODE_PEER_CONNECTION_CREATE_DATA_CHANNEL_FAILED | The stage connection could not create the channel that carries messages, so messages cannot be sent or received on it.
|
| AWS_IVS_REALTIME_ERROR_CODE_PEER_CONNECTION_DATA_CHANNEL_CLOSED | A message was handed to the transport, but the channel closed before reporting what became of it, so it may or may not have been delivered.
|
| AWS_IVS_REALTIME_ERROR_CODE_PEER_CONNECTION_DATA_CHANNEL_SEND_ENCODE_FAILED | A message could not be sent because its contents could not be encoded. A required field was empty; the error message names the field at fault.
|
| AWS_IVS_REALTIME_ERROR_CODE_PEER_CONNECTION_DATA_CHANNEL_NOT_OPEN | A message was not sent because the channel that carries it was not open, usually because the local participant was not publishing, or stopped before the message went out. The error message carries the id of the message affected.
|
| AWS_IVS_REALTIME_ERROR_CODE_PEER_CONNECTION_DATA_CHANNEL_SEND_REJECTED | A message was refused before being sent, because it was larger than the maximum, the send rate was above the maximum, or the transport would not accept it. Read the error message for which limit was hit, and send smaller or fewer messages.
|
| AWS_IVS_REALTIME_ERROR_CODE_PEER_CONNECTION_DATA_CHANNEL_RECEIVE_DECODE_FAILED | A message arrived but could not be read, so it was dropped.
|
| AWS_IVS_REALTIME_ERROR_CODE_PEER_CONNECTION_CUE_SEND_CANCELLED | A cue was handed to the transport, but the application released the stream it was sent on before its outcome arrived, so it may or may not have been delivered.
|
| AWS_IVS_REALTIME_ERROR_CODE_NO_PUBLISH_AUDIO_PACKETS_SENT | No audio packets are being sent through the publish connection. Check that audio input is active and not muted.
|
| AWS_IVS_REALTIME_ERROR_CODE_NO_PUBLISH_VIDEO_PACKETS_SENT | No video packets are being sent through the publish connection. Check that video samples are being submitted.
|
| AWS_IVS_REALTIME_ERROR_CODE_NO_SUBSCRIBE_AUDIO_PACKETS_RECEIVED | No audio packets are being received from the subscribed participant. The participant may have stopped publishing audio or network connectivity is lost.
|
| AWS_IVS_REALTIME_ERROR_CODE_NO_SUBSCRIBE_VIDEO_PACKETS_RECEIVED | No video packets are being received from the subscribed participant. The participant may have stopped publishing video without muting or network connectivity is lost.
|
| AWS_IVS_REALTIME_ERROR_CODE_SET_LAYER_REQUEST_FAILED | Failed to set video quality layer for participant stream. This operation will be automatically retried, but this may indicate a network connectivity issue.
|
| AWS_IVS_REALTIME_ERROR_CODE_SET_LAYER_REQUEST_THROTTLED | Video quality layer selection is being rate limited. This operation will be automatically retried after a delay.
|
| AWS_IVS_REALTIME_ERROR_CODE_GET_LAYER_REQUEST_FAILED | Failed to retrieve available video quality layers for participant stream. This operation will be automatically retried, but this may indicate a network connectivity issue.
|
| AWS_IVS_REALTIME_ERROR_CODE_GET_LAYER_REQUEST_THROTTLED | Video quality layer query is being rate limited. This operation will be automatically retried after a delay.
|
| AWS_IVS_REALTIME_ERROR_CODE_STAGE_SET_AUDIO_CALLBACK_WHILE_JOINED | The Stage audio callback was set while the Stage is joined. Set it before joining or after leaving.
|
| AWS_IVS_REALTIME_ERROR_CODE_STAGE_STREAM_NOT_AUDIO | A PCM callback was set on a stream that is not an audio stream. Set PCM callbacks only on audio streams.
|
| AWS_IVS_REALTIME_ERROR_CODE_STAGE_STREAM_ENDED | A PCM callback was set on a stream that has ended. Register on the stream delivered by the next streams-added event.
|
| AWS_IVS_REALTIME_ERROR_CODE_SUBTITLE_STREAM_NOT_PUBLISHING | A subtitle cue was sent on a stream the local participant is not publishing. Return the stream from the streams-to-publish strategy callback first.
|
| AWS_IVS_REALTIME_ERROR_CODE_AUDIO_SOURCE_BUFFER_SIZE_MISMATCH | The pushed audio buffer size does not match the frame count, channel count, and sample format of the audio source.
|
| AWS_IVS_REALTIME_ERROR_CODE_CHANNEL_TRANSCRIPTION_NO_PARTICIPANT | A transcription was written while no participant has subscribed audio, so it cannot be attributed.
|
| AWS_IVS_REALTIME_ERROR_CODE_CHANNEL_TRANSCRIPTION_INVALID_TIME_RANGE | A transcription was written with an end time that is not after its start time.
|
| AWS_IVS_REALTIME_ERROR_CODE_CHANNEL_TRANSCRIPTION_STALE | A transcription was written with a start time that lags the live audio position by more than the maximum transcription age.
|
| AWS_IVS_REALTIME_ERROR_CODE_CHANNEL_TRANSCRIPTION_CAPTURE_TIME_UNAVAILABLE | No absolute capture time was received on the subscribed audio stream, so transcriptions cannot be delivered. The publisher must send the abs-capture- time RTP header extension.
|
| AWS_IVS_REALTIME_ERROR_CODE_CHANNEL_TRANSCRIBER_NOT_ATTACHED | A transcription was written before the transcriber's strategy was passed to a Stage.
|
| AWS_IVS_REALTIME_ERROR_CODE_INVALID_ARGUMENT | A required argument was null or out of range. Check the arguments passed to the function that returned this code.
|