Skip to main content

Interface: NativeCastMediaErrorEvent

Defined in: packages/cast/src/specs/cast.nitro.ts:272

Receiver-side media failure. The TS layer folds this into the cast-receiver-fetch error family.

Fires on both platforms, from different sources:

  • Android — the SDK's own out-of-band callback, RemoteMediaClient.Callback.onMediaError(MediaError), carrying getDetailedErrorCode() and getReason().
  • iOS — synthesized natively from the media status (playerState == .idle && idleReason == .error), once per idle period.

CEILING — the detail fields are Android-only. GoogleCast 4.8.6 has no media-error callback: GCKRemoteMediaClientListener (GCKRemoteMediaClient.h) declares ten optional methods and not one of them reports an error, and GCKMediaStatus (GCKMediaStatus.h) has no error code/reason property — the only error surface the SDK exposes is a failed GCKRequest, which is per-request, not out-of-band. So on iOS both fields below are always absent. Branch on the CastError's code, never on the presence of these.

Properties​

detailedErrorCode?​

optional detailedErrorCode?: number;

Defined in: packages/cast/src/specs/cast.nitro.ts:274

Receiver's detailed error code, when provided. Android only.

reason?​

optional reason?: string;

Defined in: packages/cast/src/specs/cast.nitro.ts:276

Receiver's error reason string, when provided. Android only.