Docs
Get startedGuidesReferenceBlogChangelog
  1. Home
  2. Reference Docs
  3. React Native
  4. Instance Methods
  5. participants()

participants()

participants()

Returns an object detailing the current meeting participants:

The object keys are local for the local participant and the participant's session_id for remote participants.

Participant properties

All participant objects include:

  • session_id - a unique ID generated each time a participant joins a meeting
  • user_id - the user's ID if set by a meeting token, otherwise the session_id
  • user_name - the user's name if set by a meeting token, iframe properties, or via setUserName()
  • local - true for the local user
  • owner - true if set by a meeting token or the user is logged into a Daily account and is a member of the room's team
  • joined_at - js Date object, the time that the user joined the room
  • record - indicates whether a participant is recording a meeting (Note: Server-based recording (cloud) is a paid feature.)
  • networkQualityState - a string representing the current network quality state of the participant. Possible values are 'good', 'warning', 'bad', and 'unknown'. For the local participant, this matches the networkState value returned by getNetworkStats().
  • tracks - an object whose keys are participant track types - audio, video, screenAudio and screenVideo - and whose values are objects with detailed information about each track.
  • permissions - an object that describes what the participant is permitted to do during this call. There are four keys on the object, each representing a permission: hasPresence, canSend, canReceive, and canAdmin.

Participant tracks properties

KeyDescriptionPossible values
subscribedWhether you (the local participant) are subscribed to a track
  • true
  • false
  • "staged": Keeps the connection for a track open, but stops any bytes from flowing across. Must be set via updateParticipant().
stateThe values represent the complete set of mutually exclusive states a track can be in, from the user's point of view.
  • "blocked": The track is blocked. See blocked field for details.
  • "off": The track is off, but not blocked (that we know of yet—it's possible that we haven't yet tried to access a device, in the case of the start_video_off room or meeting token property, say). See off field for details.
  • "sendable": The track is ready to be sent, but simply hasn't been subscribed to. It's neither blocked nor off.
  • "loading": The track is loading. It has been subscribed to, and is neither blocked nor off.
  • "playable": The track is ready to be played. It has been subscribed to, has finished loading, and is neither blocked nor off.
  • "interrupted": The track is currently unplayable (MediaStreamTrack.muted property is true). It may enter this state from the playable state.
offIf the track is off, why it's off (this field only acquires a value if the track is off).An optional object with the properties byUser, byRemoteRequest, byBandwidth, byCanSendPermission, byCanReceivePermission (remote participants only), or byServerLimit, representing the possible reasons the track is off.
blockedIf the track is blocked, why it's blocked (this field only acquires a value if the track is blocked).An optional object with the properties byMissingDevice, byPermissions, or byDeviceInUse representing the possible reasons the track is blocked.
trackA MediaStreamTrack that is ready to be played.

tracks in action

Participant permissions properties

KeyDescriptionPossible values
hasPresenceWhether the participant appears as "present" in the call, i.e. whether they appear in participants().
  • true
  • false
canSendWhich types of media a participant should be permitted to send.
  • A Set containing any of 'video', 'audio', 'screenVideo', and 'screenAudio'
  • true (meaning "all")
  • false (meaning "none")
canReceiveWhich types of media the participant should be permitted to receive from whom.An object specifying which media the participant should be permitted to receive. Adheres to the format specified in the following section.
canAdminWhich types of admin tasks a participant should be permitted to do.
  • A Set containing any of 'participants', 'streaming', and 'transcription'
  • true (meaning "all")
  • false (meaning "none")

permissions in action

permissions.canReceive properties

KeyDescriptionPossible values
baseWhich types of media the participant should be permitted to receive from any remote participant.

For a given remote participant, the setting for each piece of media may be overridden by a corresponding setting in byUserId or byParticipantId.
  • true (meaning "all")
  • false (meaning "none")
  • An object mapping each individual media type to a boolean (see below for example)
byUserIdA mapping between remote user_ids and the media types the local participant should be permitted to receive from that participant.

For a given remote participant, the setting for each piece of media provided here overrides the corresponding setting in base.		An object mapping between remote user_ids and either:
  • true (meaning "all")
  • false (meaning "none")
  • An object mapping one or more individual media types to a boolean (see below for example)
byParticipantIdA mapping between remote participant IDs and the media types the local participant should be permitted to receive from that participant.

For a given remote participant, the setting for each piece of media provided here overrides the corresponding setting in base and byUserId.		An object mapping between remote participant IDs and either:
  • true (meaning "all")
  • false (meaning "none")
  • An object mapping one or more individual media types to a boolean (see below for example)

Optional properties

A note about the audio, video, and screen properties

These three properties' boolean values indicate whether the corresponding audio, video, or screen track is available locally and ready to be sent.

However, when a track isn't yet available ("loading"), the value will briefly be false.

We highly recommend skipping these properties and using the tracks property's key for each kind of track instead for more accurate, detailed tracks state.

A note about the audioTrack, videoTrack, and screenVideoTrack properties

These properties include the direct MediaStreamTrack that a participant is sending, if available.

We recommend skipping these properties and using the tracks property's key for each kind of track instead.

A note about the networkThreshold property

This property corresponds to the deprecated threshold value in getNetworkStats().

We recommend skipping this property and using the networkQualityState property instead.

Previous
Next