DailyTrackState

DailyTrackState describes the current condition of one media track — camera, microphone, screen share, or custom — from the local participant’s point of view. It appears as a value in DailyParticipant.tracks.

interface DailyTrackState {
  subscribed: boolean | 'staged';
  state: 'blocked' | 'off' | 'sendable' | 'loading' | 'interrupted' | 'playable';
  off?: {
    byUser?: boolean;
    byRemoteRequest?: boolean;
    byBandwidth?: boolean;
    byCanSendPermission?: boolean;
    byCanReceivePermission?: boolean;
    byServerLimit?: boolean;
  };
  blocked?: {
    byDeviceMissing?: boolean;
    byDeviceInUse?: boolean;
    byPermissions?: boolean;
  };
  track?: MediaStreamTrack;
  persistentTrack?: MediaStreamTrack;
}

Properties

true | false | 'staged'

Whether the local participant is subscribed to this track. Only meaningful for remote participants — local tracks are always implicitly subscribed.

true — subscribed and receiving
false — not subscribed
'staged' — SDP negotiated but no bytes are flowing; track can transition to playable faster when set to true

Set via updateParticipant() with setSubscribedTracks.

string

The complete, mutually exclusive state of the track from the local participant’s point of view.

Value	Meaning
`'blocked'`	Track cannot be sent. Check `blocked` for the cause.
`'off'`	Track is intentionally not being sent. Check `off` for the cause.
`'sendable'`	Track is available to send but the local participant hasn’t subscribed to it yet.
`'loading'`	Track is subscribed and the stream is being established.
`'playable'`	Track is live and ready to render.
`'interrupted'`	Track was `playable` but has transiently stalled (network fluctuation, iOS background). May return to `playable`.

object

Present when state is 'off'. Indicates why the track is off. All sub-fields are optional booleans.

Show off properties

boolean

The sender muted their own track.

boolean

An admin muted this participant’s track remotely.

boolean

Daily paused the track due to bandwidth constraints.

boolean

The participant does not have permission to send this track type.

boolean

Remote participants only. The local participant does not have permission to receive this track.

boolean

A server-side participant limit has been reached.

object

Present when state is 'blocked'. Indicates why the track cannot be sent. All sub-fields are optional booleans.

Show blocked properties

boolean

No device of this type is available.

boolean

The device is in use by another application.

boolean

The user has denied browser permissions for this device.

MediaStreamTrack | undefined

The underlying MediaStreamTrack. Only present when state === 'playable'. Only available in call object mode.Prefer persistentTrack for attaching to media elements.

MediaStreamTrack | undefined

The underlying MediaStreamTrack. Present whenever a track exists, regardless of state. Only available in call object mode.Recommended over track as a proactive defense against black frames during call disruptions and browser limitations. Use track only when you need a guarantee that media is currently flowing.

Types

DailyParticipant

Methods

Events

Guides

Tracks and Media

DailyStreamingOptions Static methods

Daily Call Client

Types

Static Methods

Instance Methods

Events

DailyTrackState

Properties

See also

Types

Methods

Events

Guides

​Properties

​See also

Types

Methods

Events

Guides

Properties

See also