public class

PlayerException

extends RuntimeException
java.lang.Object
   ↳ java.lang.Throwable
     ↳ java.lang.Exception
       ↳ java.lang.RuntimeException
         ↳ com.amazonaws.ivs.player.PlayerException

Class Overview

Represents an error that occurred during media playback. The exception has additional properties that can uniquely identify the exception.

Some valuable errors to handle:

  • source: MasterPlaylist type: ERROR_AUTHORIZATION code: 403 - This is a private stream and viewer authorization is missing or invalid.
  • source: MasterPlaylist type: ERROR_NOT_AVAILABLE code: 429 - The concurrent-viewers limit has been reached. See Amazon IVS Service Quotas.
  • source: MasterPlaylist type: ERROR_NOT_AVAILABLE code: 404 - The stream is invalid (e.g., the playback URL is incorrect) or not online.

Summary

Public Methods
int getCode()
String getErrorMessage()
ErrorType getErrorType()
String getSource()
[Expand]
Inherited Methods
From class java.lang.Throwable
From class java.lang.Object

Public Methods

public int getCode ()

Returns
  • A code representing the specific error condition. The code values depend on the source and result types. For example, if getSource() is "Segment", the result is ERROR_NETWORK, and the code value is 400, this indicates that an HTTP 400 error occurred while trying to download a video segment.

public String getErrorMessage ()

Returns
  • A message describing the error. This differs from getMessage() in that this contains only the error text and not any source or code value.

public ErrorType getErrorType ()

Returns
  • The result code for the error.

public String getSource ()

Returns
  • The source component within the player that generated the error.