Display Error

When a playback error occurs, ByteArk Player delivers onPlaybackError(error) through ByteArkPlayerListener. Your app can present the error however it wants.

Receive errors

final listener = ByteArkPlayerListener(
  onPlaybackError: (ByteArkPlayerPlaybackErrorData error) {
    showDialog(
      context: context,
      builder: (context) => AlertDialog(
        title: const Text("Cannot play this video"),
        content: Text(error.message ?? "Unknown error"),
        actions: [
          TextButton(
            onPressed: () => Navigator.pop(context),
            child: const Text("Close"),
          ),
        ],
      ),
    );
  },
);

Suggested handling

• Show a viewer-friendly message — translate the raw error.message from the SDK into language a general viewer understands.
• Allow retry — for network or source errors, give viewers a way to retry.
• Log for analysis — log error.code and error.message for debugging.

See Errors Reference for error category details.