useRecordingInstances

useRecordingInstances(): RecordingInstanceState[]

useRecordingInstances returns an array of all recording instance states. This is useful when working with multi-instance recording to enumerate and display all active (and recently stopped) recording instances.

Return type

An array of RecordingInstanceState objects, each with the following properties:

NameTypeDescription
errorbooleantrue if this instance encountered a recording error
errorMsgstringError message for this instance, if any
instanceIdstringThe unique identifier for this recording instance
isLocalParticipantRecordedbooleanWhether the local participant is recorded by this instance
isRecordingbooleanWhether this instance is currently recording
layoutObjectThe recording layout configuration for this instance
localbooleantrue if this is a local recording
recordingIdstringThe recording ID for this instance
recordingStartedDateDateWhen this instance started recording
startedBystringThe session ID of the participant who started this recording
typestringThe recording type (e.g., 'cloud', 'local')

Sample code

Related references