@livekit/components-js-docs 0.1.55 → 0.1.57

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -9,7 +9,7 @@
9
9
 
10
10
  # useDataChannel
11
11
 
12
- The `useDataChannel` hook returns the ability to send and receive messages. By optionally passing a `topic`<!-- -->, you can narrow down which messages are returned in the messages array.
12
+ The `useDataChannel` hook returns the ability to send and receive messages. Pass an optional `topic` to narrow down which messages are returned in the messages array.
13
13
 
14
14
  ## Import
15
15
 
@@ -23,6 +23,8 @@ There is only one data channel. Passing a `topic` does not open a new data chann
23
23
 
24
24
  ## Usage
25
25
 
26
+ ### Example 1
27
+
26
28
  ```tsx
27
29
  // Send messages to all participants via the 'chat' topic.
28
30
  const { message: latestMessage, send } = useDataChannel("chat", (msg) =>
@@ -30,6 +32,15 @@ const { message: latestMessage, send } = useDataChannel("chat", (msg) =>
30
32
  );
31
33
  ```
32
34
 
35
+ ### Example 2
36
+
37
+ ```tsx
38
+ // Receive all messages (no topic filtering)
39
+ const { message: latestMessage, send } = useDataChannel((msg) =>
40
+ console.log("message received", msg)
41
+ );
42
+ ```
43
+
33
44
  ## Properties
34
45
 
35
46
  {% parameter name="topic" type="T" optional=false %}
@@ -71,8 +71,8 @@
71
71
  | [useConnectionQualityIndicator(options)](./react/hook/useconnectionqualityindicator.md) | The <code>useConnectionQualityIndicator</code> hook provides props for the <code>ConnectionQualityIndicator</code> or your custom implementation of it component. |
72
72
  | [useConnectionState(room)](./react/hook/useconnectionstate.md) | The <code>useConnectionState</code> hook allows you to simply implement your own <code>ConnectionState</code> component. |
73
73
  | [useCreateLayoutContext()](./react/hook/usecreatelayoutcontext.md) | |
74
- | [useDataChannel(topic, onMessage)](./react/hook/usedatachannel.md) | The <code>useDataChannel</code> hook returns the ability to send and receive messages. By optionally passing a <code>topic</code>, you can narrow down which messages are returned in the messages array. |
75
- | [useDataChannel(onMessage)](./react/hook/usedatachannel_1.md) | The <code>useDataChannel</code> hook returns the ability to send and receive messages. |
74
+ | [useDataChannel(topic, onMessage)](./react/hook/usedatachannel.md) | The <code>useDataChannel</code> hook returns the ability to send and receive messages. Pass an optional <code>topic</code> to narrow down which messages are returned in the messages array. |
75
+ | [useDataChannel(onMessage)](./react/hook/usedatachannel_1.md) | Overload for <code>useDataChannel</code> without a topic. See [useDataChannel()](./react/hook/usedatachannel.md) for information and usage examples. |
76
76
  | [useDisconnectButton(props)](./react/hook/usedisconnectbutton.md) | The <code>useDisconnectButton</code> hook is used to implement the <code>DisconnectButton</code> or your custom implementation of it. It adds onClick handler to the button to disconnect from the room. |
77
77
  | [useEnsureCreateLayoutContext(layoutContext)](./react/hook/useensurecreatelayoutcontext.md) | |
78
78
  | [useEnsureLayoutContext(layoutContext)](./react/hook/useensurelayoutcontext.md) | Ensures that a layout context is provided, either via context or explicitly as a parameter. If not inside a <code>LayoutContext</code> and no layout context is provided, an error is thrown. |
@@ -1 +1 @@
1
- {"components":[{"filename":"audioconference.md","title":"AudioConference"},{"filename":"audiotrack.md","title":"AudioTrack"},{"filename":"audiovisualizer.md","title":"AudioVisualizer"},{"filename":"barvisualizer.md","title":"BarVisualizer"},{"filename":"carousellayout.md","title":"CarouselLayout"},{"filename":"chat.md","title":"Chat"},{"filename":"chatentry.md","title":"ChatEntry"},{"filename":"chattoggle.md","title":"ChatToggle"},{"filename":"clearpinbutton.md","title":"ClearPinButton"},{"filename":"connectionqualityindicator.md","title":"ConnectionQualityIndicator"},{"filename":"connectionstate.md","title":"ConnectionState"},{"filename":"connectionstatetoast.md","title":"ConnectionStateToast"},{"filename":"controlbar.md","title":"ControlBar"},{"filename":"disconnectbutton.md","title":"DisconnectButton"},{"filename":"focuslayout.md","title":"FocusLayout"},{"filename":"focuslayoutcontainer.md","title":"FocusLayoutContainer"},{"filename":"focustoggle.md","title":"FocusToggle"},{"filename":"gridlayout.md","title":"GridLayout"},{"filename":"layoutcontext.md","title":"LayoutContext"},{"filename":"layoutcontextprovider.md","title":"LayoutContextProvider"},{"filename":"livekitroom.md","title":"LiveKitRoom"},{"filename":"mediadevicemenu.md","title":"MediaDeviceMenu"},{"filename":"mediadeviceselect.md","title":"MediaDeviceSelect"},{"filename":"participantaudiotile.md","title":"ParticipantAudioTile"},{"filename":"participantcontext.md","title":"ParticipantContext"},{"filename":"participantcontextifneeded.md","title":"ParticipantContextIfNeeded"},{"filename":"participantloop.md","title":"ParticipantLoop"},{"filename":"participantname.md","title":"ParticipantName"},{"filename":"participanttile.md","title":"ParticipantTile"},{"filename":"prejoin.md","title":"PreJoin"},{"filename":"roomaudiorenderer.md","title":"RoomAudioRenderer"},{"filename":"roomcontext.md","title":"RoomContext"},{"filename":"roomname.md","title":"RoomName"},{"filename":"startaudio.md","title":"StartAudio"},{"filename":"startmediabutton.md","title":"StartMediaButton"},{"filename":"toast.md","title":"Toast"},{"filename":"trackloop.md","title":"TrackLoop"},{"filename":"trackmutedindicator.md","title":"TrackMutedIndicator"},{"filename":"trackrefcontext.md","title":"TrackRefContext"},{"filename":"tracktoggle.md","title":"TrackToggle"},{"filename":"videoconference.md","title":"VideoConference"},{"filename":"videotrack.md","title":"VideoTrack"},{"filename":"voiceassistantcontrolbar.md","title":"VoiceAssistantControlBar"}],"hooks":[{"filename":"useaudioplayback.md","title":"useAudioPlayback"},{"filename":"useaudiowaveform.md","title":"useAudioWaveform"},{"filename":"usechat.md","title":"useChat"},{"filename":"usechattoggle.md","title":"useChatToggle"},{"filename":"useclearpinbutton.md","title":"useClearPinButton"},{"filename":"useconnectionqualityindicator.md","title":"useConnectionQualityIndicator"},{"filename":"useconnectionstate.md","title":"useConnectionState"},{"filename":"usecreatelayoutcontext.md","title":"useCreateLayoutContext"},{"filename":"usedatachannel.md","title":"useDataChannel"},{"filename":"usedatachannel_1.md","title":"useDataChannel"},{"filename":"usedisconnectbutton.md","title":"useDisconnectButton"},{"filename":"useensurecreatelayoutcontext.md","title":"useEnsureCreateLayoutContext"},{"filename":"useensurelayoutcontext.md","title":"useEnsureLayoutContext"},{"filename":"useensureparticipant.md","title":"useEnsureParticipant"},{"filename":"useensureroom.md","title":"useEnsureRoom"},{"filename":"useensuretrackref.md","title":"useEnsureTrackRef"},{"filename":"usefacingmode.md","title":"useFacingMode"},{"filename":"usefocustoggle.md","title":"useFocusToggle"},{"filename":"usegridlayout.md","title":"useGridLayout"},{"filename":"useisencrypted.md","title":"useIsEncrypted"},{"filename":"useismuted.md","title":"useIsMuted"},{"filename":"useisrecording.md","title":"useIsRecording"},{"filename":"useisspeaking.md","title":"useIsSpeaking"},{"filename":"usekrispnoisefilter.md","title":"useKrispNoiseFilter"},{"filename":"uselayoutcontext.md","title":"useLayoutContext"},{"filename":"uselivekitroom.md","title":"useLiveKitRoom"},{"filename":"uselocalparticipant.md","title":"useLocalParticipant"},{"filename":"uselocalparticipantpermissions.md","title":"useLocalParticipantPermissions"},{"filename":"usemaybelayoutcontext.md","title":"useMaybeLayoutContext"},{"filename":"usemaybeparticipantcontext.md","title":"useMaybeParticipantContext"},{"filename":"usemayberoomcontext.md","title":"useMaybeRoomContext"},{"filename":"usemaybetrackrefcontext.md","title":"useMaybeTrackRefContext"},{"filename":"usemediadevices.md","title":"useMediaDevices"},{"filename":"usemediadeviceselect.md","title":"useMediaDeviceSelect"},{"filename":"usemultibandtrackvolume.md","title":"useMultibandTrackVolume"},{"filename":"usepagination.md","title":"usePagination"},{"filename":"useparticipantattribute.md","title":"useParticipantAttribute"},{"filename":"useparticipantattributes.md","title":"useParticipantAttributes"},{"filename":"useparticipantcontext.md","title":"useParticipantContext"},{"filename":"useparticipantinfo.md","title":"useParticipantInfo"},{"filename":"useparticipantpermissions.md","title":"useParticipantPermissions"},{"filename":"useparticipants.md","title":"useParticipants"},{"filename":"useparticipanttile.md","title":"useParticipantTile"},{"filename":"useparticipanttracks.md","title":"useParticipantTracks"},{"filename":"usepersistentuserchoices.md","title":"usePersistentUserChoices"},{"filename":"usepinnedtracks.md","title":"usePinnedTracks"},{"filename":"usepreviewdevice.md","title":"usePreviewDevice"},{"filename":"usepreviewtracks.md","title":"usePreviewTracks"},{"filename":"useremoteparticipant.md","title":"useRemoteParticipant"},{"filename":"useremoteparticipant_1.md","title":"useRemoteParticipant"},{"filename":"useremoteparticipants.md","title":"useRemoteParticipants"},{"filename":"useroomcontext.md","title":"useRoomContext"},{"filename":"useroominfo.md","title":"useRoomInfo"},{"filename":"usesortedparticipants.md","title":"useSortedParticipants"},{"filename":"usespeakingparticipants.md","title":"useSpeakingParticipants"},{"filename":"usestartaudio.md","title":"useStartAudio"},{"filename":"usestartvideo.md","title":"useStartVideo"},{"filename":"useswipe.md","title":"useSwipe"},{"filename":"usetextstream.md","title":"useTextStream"},{"filename":"usetoken.md","title":"useToken"},{"filename":"usetrackbyname.md","title":"useTrackByName"},{"filename":"usetrackmutedindicator.md","title":"useTrackMutedIndicator"},{"filename":"usetrackrefcontext.md","title":"useTrackRefContext"},{"filename":"usetracks.md","title":"useTracks"},{"filename":"usetracktoggle.md","title":"useTrackToggle"},{"filename":"usetracktranscription.md","title":"useTrackTranscription"},{"filename":"usetrackvolume.md","title":"useTrackVolume"},{"filename":"usevisualstableupdate.md","title":"useVisualStableUpdate"},{"filename":"usevoiceassistant.md","title":"useVoiceAssistant"}]}
1
+ {"components":[{"filename":"audioconference.md","title":"AudioConference"},{"filename":"audiotrack.md","title":"AudioTrack"},{"filename":"audiovisualizer.md","title":"AudioVisualizer"},{"filename":"barvisualizer.md","title":"BarVisualizer"},{"filename":"carousellayout.md","title":"CarouselLayout"},{"filename":"chat.md","title":"Chat"},{"filename":"chatentry.md","title":"ChatEntry"},{"filename":"chattoggle.md","title":"ChatToggle"},{"filename":"clearpinbutton.md","title":"ClearPinButton"},{"filename":"connectionqualityindicator.md","title":"ConnectionQualityIndicator"},{"filename":"connectionstate.md","title":"ConnectionState"},{"filename":"connectionstatetoast.md","title":"ConnectionStateToast"},{"filename":"controlbar.md","title":"ControlBar"},{"filename":"disconnectbutton.md","title":"DisconnectButton"},{"filename":"focuslayout.md","title":"FocusLayout"},{"filename":"focuslayoutcontainer.md","title":"FocusLayoutContainer"},{"filename":"focustoggle.md","title":"FocusToggle"},{"filename":"gridlayout.md","title":"GridLayout"},{"filename":"layoutcontext.md","title":"LayoutContext"},{"filename":"layoutcontextprovider.md","title":"LayoutContextProvider"},{"filename":"livekitroom.md","title":"LiveKitRoom"},{"filename":"mediadevicemenu.md","title":"MediaDeviceMenu"},{"filename":"mediadeviceselect.md","title":"MediaDeviceSelect"},{"filename":"participantaudiotile.md","title":"ParticipantAudioTile"},{"filename":"participantcontext.md","title":"ParticipantContext"},{"filename":"participantcontextifneeded.md","title":"ParticipantContextIfNeeded"},{"filename":"participantloop.md","title":"ParticipantLoop"},{"filename":"participantname.md","title":"ParticipantName"},{"filename":"participanttile.md","title":"ParticipantTile"},{"filename":"prejoin.md","title":"PreJoin"},{"filename":"roomaudiorenderer.md","title":"RoomAudioRenderer"},{"filename":"roomcontext.md","title":"RoomContext"},{"filename":"roomname.md","title":"RoomName"},{"filename":"startaudio.md","title":"StartAudio"},{"filename":"startmediabutton.md","title":"StartMediaButton"},{"filename":"toast.md","title":"Toast"},{"filename":"trackloop.md","title":"TrackLoop"},{"filename":"trackmutedindicator.md","title":"TrackMutedIndicator"},{"filename":"trackrefcontext.md","title":"TrackRefContext"},{"filename":"tracktoggle.md","title":"TrackToggle"},{"filename":"videoconference.md","title":"VideoConference"},{"filename":"videotrack.md","title":"VideoTrack"},{"filename":"voiceassistantcontrolbar.md","title":"VoiceAssistantControlBar"}],"hooks":[{"filename":"useaudioplayback.md","title":"useAudioPlayback"},{"filename":"useaudiowaveform.md","title":"useAudioWaveform"},{"filename":"usechat.md","title":"useChat"},{"filename":"usechattoggle.md","title":"useChatToggle"},{"filename":"useclearpinbutton.md","title":"useClearPinButton"},{"filename":"useconnectionqualityindicator.md","title":"useConnectionQualityIndicator"},{"filename":"useconnectionstate.md","title":"useConnectionState"},{"filename":"usecreatelayoutcontext.md","title":"useCreateLayoutContext"},{"filename":"usedatachannel.md","title":"useDataChannel"},{"filename":"usedisconnectbutton.md","title":"useDisconnectButton"},{"filename":"useensurecreatelayoutcontext.md","title":"useEnsureCreateLayoutContext"},{"filename":"useensurelayoutcontext.md","title":"useEnsureLayoutContext"},{"filename":"useensureparticipant.md","title":"useEnsureParticipant"},{"filename":"useensureroom.md","title":"useEnsureRoom"},{"filename":"useensuretrackref.md","title":"useEnsureTrackRef"},{"filename":"usefacingmode.md","title":"useFacingMode"},{"filename":"usefocustoggle.md","title":"useFocusToggle"},{"filename":"usegridlayout.md","title":"useGridLayout"},{"filename":"useisencrypted.md","title":"useIsEncrypted"},{"filename":"useismuted.md","title":"useIsMuted"},{"filename":"useisrecording.md","title":"useIsRecording"},{"filename":"useisspeaking.md","title":"useIsSpeaking"},{"filename":"usekrispnoisefilter.md","title":"useKrispNoiseFilter"},{"filename":"uselayoutcontext.md","title":"useLayoutContext"},{"filename":"uselivekitroom.md","title":"useLiveKitRoom"},{"filename":"uselocalparticipant.md","title":"useLocalParticipant"},{"filename":"uselocalparticipantpermissions.md","title":"useLocalParticipantPermissions"},{"filename":"usemaybelayoutcontext.md","title":"useMaybeLayoutContext"},{"filename":"usemaybeparticipantcontext.md","title":"useMaybeParticipantContext"},{"filename":"usemayberoomcontext.md","title":"useMaybeRoomContext"},{"filename":"usemaybetrackrefcontext.md","title":"useMaybeTrackRefContext"},{"filename":"usemediadevices.md","title":"useMediaDevices"},{"filename":"usemediadeviceselect.md","title":"useMediaDeviceSelect"},{"filename":"usemultibandtrackvolume.md","title":"useMultibandTrackVolume"},{"filename":"usepagination.md","title":"usePagination"},{"filename":"useparticipantattribute.md","title":"useParticipantAttribute"},{"filename":"useparticipantattributes.md","title":"useParticipantAttributes"},{"filename":"useparticipantcontext.md","title":"useParticipantContext"},{"filename":"useparticipantinfo.md","title":"useParticipantInfo"},{"filename":"useparticipantpermissions.md","title":"useParticipantPermissions"},{"filename":"useparticipants.md","title":"useParticipants"},{"filename":"useparticipanttile.md","title":"useParticipantTile"},{"filename":"useparticipanttracks.md","title":"useParticipantTracks"},{"filename":"usepersistentuserchoices.md","title":"usePersistentUserChoices"},{"filename":"usepinnedtracks.md","title":"usePinnedTracks"},{"filename":"usepreviewdevice.md","title":"usePreviewDevice"},{"filename":"usepreviewtracks.md","title":"usePreviewTracks"},{"filename":"useremoteparticipant.md","title":"useRemoteParticipant"},{"filename":"useremoteparticipants.md","title":"useRemoteParticipants"},{"filename":"useroomcontext.md","title":"useRoomContext"},{"filename":"useroominfo.md","title":"useRoomInfo"},{"filename":"usesortedparticipants.md","title":"useSortedParticipants"},{"filename":"usespeakingparticipants.md","title":"useSpeakingParticipants"},{"filename":"usestartaudio.md","title":"useStartAudio"},{"filename":"usestartvideo.md","title":"useStartVideo"},{"filename":"useswipe.md","title":"useSwipe"},{"filename":"usetextstream.md","title":"useTextStream"},{"filename":"usetoken.md","title":"useToken"},{"filename":"usetrackbyname.md","title":"useTrackByName"},{"filename":"usetrackmutedindicator.md","title":"useTrackMutedIndicator"},{"filename":"usetrackrefcontext.md","title":"useTrackRefContext"},{"filename":"usetracks.md","title":"useTracks"},{"filename":"usetracktoggle.md","title":"useTrackToggle"},{"filename":"usetracktranscription.md","title":"useTrackTranscription"},{"filename":"usetrackvolume.md","title":"useTrackVolume"},{"filename":"usevisualstableupdate.md","title":"useVisualStableUpdate"},{"filename":"usevoiceassistant.md","title":"useVoiceAssistant"}]}
@@ -12,6 +12,8 @@ This feature is under active development and may change based on developer feedb
12
12
 
13
13
  {% /callout %}
14
14
 
15
+ The agent participant.
16
+
15
17
  **Signature:**
16
18
 
17
19
  ```typescript
@@ -12,6 +12,8 @@ This feature is under active development and may change based on developer feedb
12
12
 
13
13
  {% /callout %}
14
14
 
15
+ The agent's participant attributes.
16
+
15
17
  **Signature:**
16
18
 
17
19
  ```typescript
@@ -12,6 +12,8 @@ This feature is under active development and may change based on developer feedb
12
12
 
13
13
  {% /callout %}
14
14
 
15
+ The transcriptions of the agent's microphone track (if any).
16
+
15
17
  **Signature:**
16
18
 
17
19
  ```typescript
@@ -12,6 +12,8 @@ This feature is under active development and may change based on developer feedb
12
12
 
13
13
  {% /callout %}
14
14
 
15
+ The microphone track published by the agent or associated avatar worker (if any).
16
+
15
17
  **Signature:**
16
18
 
17
19
  ```typescript
@@ -23,10 +23,11 @@ export interface VoiceAssistant
23
23
 
24
24
  ## Properties
25
25
 
26
- | Property | Type | Description |
27
- | -------------------------------------------------------------------- | ---------------------------------------------- | ------------ |
28
- | [agent](./react/voiceassistant.agent.md) | RemoteParticipant \| undefined | **_(BETA)_** |
29
- | [agentAttributes](./react/voiceassistant.agentattributes.md) | RemoteParticipant\['attributes'\] \| undefined | **_(BETA)_** |
30
- | [agentTranscriptions](./react/voiceassistant.agenttranscriptions.md) | ReceivedTranscriptionSegment\[\] | **_(BETA)_** |
31
- | [audioTrack](./react/voiceassistant.audiotrack.md) | TrackReference \| undefined | **_(BETA)_** |
32
- | [state](./react/voiceassistant.state.md) | [AgentState](./react/agentstate.md) | **_(BETA)_** |
26
+ | Property | Type | Description |
27
+ | -------------------------------------------------------------------- | ---------------------------------------------- | ---------------------------------------------------------------------------------------------- |
28
+ | [agent](./react/voiceassistant.agent.md) | RemoteParticipant \| undefined | **_(BETA)_** The agent participant. |
29
+ | [agentAttributes](./react/voiceassistant.agentattributes.md) | RemoteParticipant\['attributes'\] \| undefined | **_(BETA)_** The agent's participant attributes. |
30
+ | [agentTranscriptions](./react/voiceassistant.agenttranscriptions.md) | ReceivedTranscriptionSegment\[\] | **_(BETA)_** The transcriptions of the agent's microphone track (if any). |
31
+ | [audioTrack](./react/voiceassistant.audiotrack.md) | TrackReference \| undefined | **_(BETA)_** The microphone track published by the agent or associated avatar worker (if any). |
32
+ | [state](./react/voiceassistant.state.md) | [AgentState](./react/agentstate.md) | **_(BETA)_** The current state of the agent. |
33
+ | [videoTrack](./react/voiceassistant.videotrack.md) | TrackReference \| undefined | **_(BETA)_** The camera track published by the agent or associated avatar worker (if any). |
@@ -12,6 +12,8 @@ This feature is under active development and may change based on developer feedb
12
12
 
13
13
  {% /callout %}
14
14
 
15
+ The current state of the agent.
16
+
15
17
  **Signature:**
16
18
 
17
19
  ```typescript
@@ -0,0 +1,21 @@
1
+ ---
2
+ { "title": "VoiceAssistant.videoTrack property" }
3
+ ---
4
+
5
+ <!-- Do not edit this file. It is automatically generated by API Documenter. -->
6
+
7
+ # VoiceAssistant.videoTrack property
8
+
9
+ {% callout type="note" variation="normal" %}
10
+
11
+ This feature is under active development and may change based on developer feedback and real-world usage.
12
+
13
+ {% /callout %}
14
+
15
+ The camera track published by the agent or associated avatar worker (if any).
16
+
17
+ **Signature:**
18
+
19
+ ```typescript
20
+ videoTrack: TrackReference | undefined;
21
+ ```
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@livekit/components-js-docs",
3
- "version": "0.1.55",
3
+ "version": "0.1.57",
4
4
  "description": "Automatically generated documentation pages for LiveKit Components JS. Intended to be consumed by the documentation page.",
5
5
  "repository": {
6
6
  "type": "git",
@@ -8,7 +8,7 @@
8
8
  "directory": "/docs/beta-docs"
9
9
  },
10
10
  "dependencies": {
11
- "@livekit/components-react": "2.9.2"
11
+ "@livekit/components-react": "2.9.4"
12
12
  },
13
13
  "author": "",
14
14
  "license": "Apache-2.0",
@@ -1,19 +0,0 @@
1
- ---
2
- {
3
- "title": "participantAttributesObserver",
4
- "linkToSource": "https://github.com/livekit/components-js/blob/main/packages/core/src/observables/participant.ts"
5
- }
6
- ---
7
-
8
- <!-- Do not edit this file. It is automatically generated by API Documenter. -->
9
-
10
- # participantAttributesObserver
11
-
12
- **Signature:**
13
-
14
- ```typescript
15
- export declare function participantAttributesObserver(participant: undefined): Observable<{
16
- changed: undefined;
17
- attributes: undefined;
18
- }>;
19
- ```
@@ -1,42 +0,0 @@
1
- ---
2
- {
3
- "title": "useDataChannel",
4
- "linkToSource": "https://github.com/livekit/components-js/blob/main/packages/react/src/hooks/useDataChannel.ts"
5
- }
6
- ---
7
-
8
- <!-- Do not edit this file. It is automatically generated by API Documenter. -->
9
-
10
- # useDataChannel
11
-
12
- The `useDataChannel` hook returns the ability to send and receive messages.
13
-
14
- ## Import
15
-
16
- ```typescript
17
- import { useDataChannel } from "@livekit/components-react";
18
- ```
19
-
20
- ## Remarks
21
-
22
- There is only one data channel. Passing a `topic` does not open a new data channel. It is only used to filter out messages with no or a different `topic`<!-- -->.
23
-
24
- ## Usage
25
-
26
- ```tsx
27
- // Send messages to all participants
28
- const { message: latestMessage, send } = useDataChannel("chat", (msg) =>
29
- console.log("message received", msg)
30
- );
31
- ```
32
-
33
- ## Properties
34
-
35
- {% parameter name="onMessage" type="(msg: ReceivedDataMessage) => void" optional=true %}
36
- {% /parameter %}
37
-
38
- ## Returns
39
-
40
- ```typescript
41
- UseDataChannelReturnType;
42
- ```
@@ -1,44 +0,0 @@
1
- ---
2
- {
3
- "title": "useRemoteParticipant",
4
- "linkToSource": "https://github.com/livekit/components-js/blob/main/packages/react/src/hooks/useRemoteParticipant.ts"
5
- }
6
- ---
7
-
8
- <!-- Do not edit this file. It is automatically generated by API Documenter. -->
9
-
10
- # useRemoteParticipant
11
-
12
- The `useRemoteParticipant` hook returns the first RemoteParticipant by either identity or based on the participant kind.
13
-
14
- ## Import
15
-
16
- ```typescript
17
- import { useRemoteParticipant } from "@livekit/components-react";
18
- ```
19
-
20
- ## Remarks
21
-
22
- To optimize performance, you can use the `updateOnlyOn` property to decide on what `ParticipantEvents` the hook updates.
23
-
24
- ## Usage
25
-
26
- ```tsx
27
- const participant = useRemoteParticipant("Russ");
28
- ```
29
-
30
- ## Properties
31
-
32
- {% parameter name="identity" type="string" optional=false %}
33
- {% /parameter %}
34
-
35
- {% parameter name="options.updateOnlyOn" type="ParticipantEvent[]" optional=true %}
36
- To optimize performance, you can use the `updateOnlyOn` property to decide on what `ParticipantEvents` the hook updates. By default it updates on all relevant ParticipantEvents to keep the returned participant up to date.
37
-
38
- {% /parameter %}
39
-
40
- ## Returns
41
-
42
- ```typescript
43
- RemoteParticipant | undefined;
44
- ```