classifyMediaErrorCode function

int classifyMediaErrorCode(
  1. Object? error
)

Classifies error — a PlatformException, string, or generic object — into the matching TelnyxErrorCodes media code.

Classification rules (case-insensitive substring match):

  • Contains "permission", "NotAllowed" → 42001 (microphone permission denied)
  • Contains "NotFound", "Overconstrained" → 42002 (device not found)
  • Everything else → 42003 (getUserMedia failed)

Implementation

int classifyMediaErrorCode(Object? error) {
  final String text;

  if (error == null) {
    return TelnyxErrorCodes.mediaGetUserMediaFailed;
  }

  if (error is PlatformException) {
    final code = error.code.toLowerCase();
    final message = error.message?.toLowerCase() ?? '';
    text = '$code $message';
  } else if (error is String) {
    text = error.toLowerCase();
  } else {
    // Generic Exception or any other object — fall through to default.
    return TelnyxErrorCodes.mediaGetUserMediaFailed;
  }

  if (text.contains('permission') || text.contains('notallowed')) {
    return TelnyxErrorCodes.mediaMicrophonePermissionDenied;
  }

  if (text.contains('notfound') || text.contains('overconstrained')) {
    return TelnyxErrorCodes.mediaDeviceNotFound;
  }

  return TelnyxErrorCodes.mediaGetUserMediaFailed;
}