@livekit/components-js-docs 0.0.2 → 0.0.3

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.
Files changed (167) hide show
  1. package/generated-docs/core/activespeakerobserver.md +1 -1
  2. package/generated-docs/core/computemenuposition.md +1 -1
  3. package/generated-docs/core/connectedparticipantobserver.md +1 -1
  4. package/generated-docs/core/connectedparticipantsobserver.md +1 -1
  5. package/generated-docs/core/connectionstateobserver.md +1 -1
  6. package/generated-docs/core/createactivedeviceobservable.md +1 -1
  7. package/generated-docs/core/createconnectionqualityobserver.md +1 -1
  8. package/generated-docs/core/createdataobserver.md +1 -1
  9. package/generated-docs/core/createisspeakingobserver.md +1 -1
  10. package/generated-docs/core/createmediadeviceobserver.md +1 -1
  11. package/generated-docs/core/createtrackobserver.md +1 -1
  12. package/generated-docs/core/gettrackbyidentifier.md +1 -1
  13. package/generated-docs/core/gettrackreferenceid.md +1 -1
  14. package/generated-docs/core/gettrackreferencesource.md +1 -1
  15. package/generated-docs/core/index.md +1 -1
  16. package/generated-docs/core/isequaltrackref.md +1 -1
  17. package/generated-docs/core/islocal.md +1 -1
  18. package/generated-docs/core/ismobilebrowser.md +1 -1
  19. package/generated-docs/core/isparticipantsourcepinned.md +1 -1
  20. package/generated-docs/core/isremote.md +1 -1
  21. package/generated-docs/core/issourceswithoptions.md +1 -1
  22. package/generated-docs/core/issourcewitoptions.md +1 -1
  23. package/generated-docs/core/istrackreference.md +1 -1
  24. package/generated-docs/core/istrackreferencepinned.md +1 -1
  25. package/generated-docs/core/istrackreferenceplaceholder.md +1 -1
  26. package/generated-docs/core/mutedobserver.md +1 -1
  27. package/generated-docs/core/observeparticipantevents.md +1 -1
  28. package/generated-docs/core/observeparticipantmedia.md +1 -1
  29. package/generated-docs/core/observeroomevents.md +1 -1
  30. package/generated-docs/core/observetrackevents.md +1 -1
  31. package/generated-docs/core/participanteventselector.md +1 -1
  32. package/generated-docs/core/participantinfoobserver.md +1 -1
  33. package/generated-docs/core/participantpermissionobserver.md +2 -2
  34. package/generated-docs/core/roomaudioplaybackallowedobservable.md +1 -1
  35. package/generated-docs/core/roomeventselector.md +1 -1
  36. package/generated-docs/core/roominfoobserver.md +1 -1
  37. package/generated-docs/core/roomobserver.md +1 -1
  38. package/generated-docs/core/screenshareobserver.md +1 -1
  39. package/generated-docs/core/selectgridlayout.md +1 -1
  40. package/generated-docs/core/sendmessage.md +1 -1
  41. package/generated-docs/core/setdifference.md +1 -1
  42. package/generated-docs/core/setloglevel.md +1 -1
  43. package/generated-docs/core/setupchat.md +8 -2
  44. package/generated-docs/core/setupchattoggle.md +1 -1
  45. package/generated-docs/core/setupclearpinbutton.md +1 -1
  46. package/generated-docs/core/setupconnectionqualityindicator.md +1 -1
  47. package/generated-docs/core/setupdatamessagehandler.md +1 -1
  48. package/generated-docs/core/setupdeviceselector.md +1 -1
  49. package/generated-docs/core/setupdisconnectbutton.md +1 -1
  50. package/generated-docs/core/setupfocustoggle.md +1 -1
  51. package/generated-docs/core/setuplivekitroom.md +1 -1
  52. package/generated-docs/core/setupmanualtoggle.md +1 -1
  53. package/generated-docs/core/setupmediatoggle.md +1 -1
  54. package/generated-docs/core/setupmediatrack.md +1 -1
  55. package/generated-docs/core/setupparticipantname.md +1 -1
  56. package/generated-docs/core/setupparticipanttile.md +1 -1
  57. package/generated-docs/core/setupstartaudio.md +1 -1
  58. package/generated-docs/core/setuptrackmutedindicator.md +1 -1
  59. package/generated-docs/core/sortparticipants.md +1 -1
  60. package/generated-docs/core/sorttrackreferences.md +1 -1
  61. package/generated-docs/core/supportsscreensharing.md +1 -1
  62. package/generated-docs/core/tokenize.md +1 -1
  63. package/generated-docs/core/trackobservable.md +1 -1
  64. package/generated-docs/core/trackreferencesobservable.md +1 -1
  65. package/generated-docs/core/updatepages.md +1 -1
  66. package/generated-docs/core/wasclickoutside.md +1 -1
  67. package/generated-docs/react/chatprops.md +2 -0
  68. package/generated-docs/react/chatprops.messagedecoder.md +9 -0
  69. package/generated-docs/react/chatprops.messageencoder.md +9 -0
  70. package/generated-docs/react/component/audioconference.md +1 -1
  71. package/generated-docs/react/component/audiotrack.md +28 -9
  72. package/generated-docs/react/component/audiovisualizer.md +5 -4
  73. package/generated-docs/react/component/carouselview.md +11 -6
  74. package/generated-docs/react/component/chat.md +15 -4
  75. package/generated-docs/react/component/chatentry.md +20 -7
  76. package/generated-docs/react/component/chattoggle.md +1 -1
  77. package/generated-docs/react/component/clearpinbutton.md +1 -1
  78. package/generated-docs/react/component/connectionqualityindicator.md +1 -1
  79. package/generated-docs/react/component/connectionstate.md +5 -4
  80. package/generated-docs/react/component/connectionstatetoast.md +5 -4
  81. package/generated-docs/react/component/controlbar.md +10 -5
  82. package/generated-docs/react/component/disconnectbutton.md +5 -4
  83. package/generated-docs/react/component/focuslayout.md +10 -5
  84. package/generated-docs/react/component/focuslayoutcontainer.md +10 -5
  85. package/generated-docs/react/component/focustoggle.md +8 -5
  86. package/generated-docs/react/component/formatchatmessagelinks.md +1 -1
  87. package/generated-docs/react/component/gridlayout.md +6 -5
  88. package/generated-docs/react/component/livekitroom.md +70 -17
  89. package/generated-docs/react/component/mediadevicemenu.md +25 -8
  90. package/generated-docs/react/component/mediadeviceselect.md +38 -11
  91. package/generated-docs/react/component/participantaudiotile.md +25 -8
  92. package/generated-docs/react/component/participantcontextifneeded.md +1 -1
  93. package/generated-docs/react/component/participantloop.md +10 -5
  94. package/generated-docs/react/component/participantname.md +1 -1
  95. package/generated-docs/react/component/participanttile.md +25 -8
  96. package/generated-docs/react/component/prejoin.md +45 -12
  97. package/generated-docs/react/component/roomaudiorenderer.md +1 -1
  98. package/generated-docs/react/component/roomname.md +5 -4
  99. package/generated-docs/react/component/startaudio.md +3 -4
  100. package/generated-docs/react/component/toast.md +1 -1
  101. package/generated-docs/react/component/trackloop.md +10 -5
  102. package/generated-docs/react/component/trackmutedindicator.md +13 -6
  103. package/generated-docs/react/component/tracktoggle.md +23 -8
  104. package/generated-docs/react/component/videoconference.md +15 -4
  105. package/generated-docs/react/component/videotrack.md +33 -9
  106. package/generated-docs/react/hook/usechat.md +11 -3
  107. package/generated-docs/react/hook/usechattoggle.md +5 -6
  108. package/generated-docs/react/hook/useclearpinbutton.md +5 -6
  109. package/generated-docs/react/hook/useconnectionqualityindicator.md +5 -6
  110. package/generated-docs/react/hook/useconnectionstate.md +5 -6
  111. package/generated-docs/react/hook/usecreatelayoutcontext.md +3 -3
  112. package/generated-docs/react/hook/usedatachannel.md +8 -7
  113. package/generated-docs/react/hook/usedatachannel_1.md +5 -6
  114. package/generated-docs/react/hook/usedisconnectbutton.md +5 -6
  115. package/generated-docs/react/hook/useensurecreatelayoutcontext.md +5 -6
  116. package/generated-docs/react/hook/useensurelayoutcontext.md +5 -6
  117. package/generated-docs/react/hook/useensureparticipant.md +5 -6
  118. package/generated-docs/react/hook/useensureroom.md +5 -6
  119. package/generated-docs/react/hook/useensuretrackreference.md +5 -6
  120. package/generated-docs/react/hook/usefocustoggle.md +5 -6
  121. package/generated-docs/react/hook/usegridlayout.md +8 -7
  122. package/generated-docs/react/hook/useismuted.md +8 -7
  123. package/generated-docs/react/hook/useisspeaking.md +5 -6
  124. package/generated-docs/react/hook/uselayoutcontext.md +3 -3
  125. package/generated-docs/react/hook/uselivekitroom.md +5 -6
  126. package/generated-docs/react/hook/uselocalparticipant.md +5 -6
  127. package/generated-docs/react/hook/uselocalparticipantpermissions.md +3 -3
  128. package/generated-docs/react/hook/usemaybelayoutcontext.md +3 -3
  129. package/generated-docs/react/hook/usemaybeparticipantcontext.md +3 -3
  130. package/generated-docs/react/hook/usemayberoomcontext.md +3 -3
  131. package/generated-docs/react/hook/usemaybetrackcontext.md +3 -3
  132. package/generated-docs/react/hook/usemediadevices.md +7 -6
  133. package/generated-docs/react/hook/usemediadeviceselect.md +5 -6
  134. package/generated-docs/react/hook/usemediatrack.md +11 -8
  135. package/generated-docs/react/hook/usemediatrackbyname.md +11 -8
  136. package/generated-docs/react/hook/useparticipantcontext.md +3 -3
  137. package/generated-docs/react/hook/useparticipantinfo.md +5 -6
  138. package/generated-docs/react/hook/useparticipantpermissions.md +5 -6
  139. package/generated-docs/react/hook/useparticipants.md +5 -6
  140. package/generated-docs/react/hook/useparticipanttile.md +5 -6
  141. package/generated-docs/react/hook/usepinnedtracks.md +5 -6
  142. package/generated-docs/react/hook/usepreviewdevice.md +11 -8
  143. package/generated-docs/react/hook/useremoteparticipant.md +8 -7
  144. package/generated-docs/react/hook/useremoteparticipants.md +5 -6
  145. package/generated-docs/react/hook/useroomcontext.md +3 -3
  146. package/generated-docs/react/hook/useroominfo.md +5 -6
  147. package/generated-docs/react/hook/usesortedparticipants.md +5 -6
  148. package/generated-docs/react/hook/usespeakingparticipants.md +3 -3
  149. package/generated-docs/react/hook/usetoken.md +11 -8
  150. package/generated-docs/react/hook/usetrackcontext.md +3 -3
  151. package/generated-docs/react/hook/usetrackmutedindicator.md +8 -7
  152. package/generated-docs/react/hook/usetracks.md +8 -7
  153. package/generated-docs/react/hook/usetracktoggle.md +5 -6
  154. package/generated-docs/react/hook/usevisualstableupdate.md +11 -8
  155. package/generated-docs/react/index.md +7 -5
  156. package/generated-docs/react/messagedecoder.md +13 -0
  157. package/generated-docs/react/messageencoder.md +13 -0
  158. package/generated-docs/react/participantloopprops.md +4 -4
  159. package/generated-docs/react/participantloopprops.participants.md +1 -1
  160. package/generated-docs/react/trackloopprops.md +4 -4
  161. package/generated-docs/react/trackloopprops.tracks.md +1 -1
  162. package/generated-docs/react/videoconferenceprops.chatmessagedecoder.md +9 -0
  163. package/generated-docs/react/videoconferenceprops.chatmessageencoder.md +9 -0
  164. package/generated-docs/react/videoconferenceprops.md +2 -0
  165. package/generated-docs/react/videotrackprops.managesubscription.md +9 -0
  166. package/generated-docs/react/videotrackprops.md +1 -0
  167. package/package.json +1 -1
@@ -1,6 +1,6 @@
1
1
  <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
2
 
3
- # MediaDeviceSelect (component)
3
+ # MediaDeviceSelect
4
4
 
5
5
  The MediaDeviceSelect list all media devices of one kind. Clicking on one of the listed devices make it the active media device.
6
6
 
@@ -22,13 +22,40 @@ import { MediaDeviceSelect } from '@livekit/components-react';
22
22
 
23
23
  ## Properties
24
24
 
25
- | Property | Type | Description |
26
- | ------------------------------------------------------------------------------- | ----------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
27
- | [exactMatch?](./react/mediadeviceselectprops.exactmatch.md) | boolean | _(Optional)_ will force the browser to only return the specified device will call <code>onDeviceSelectError</code> with the error in case this fails |
28
- | [initialSelection?](./react/mediadeviceselectprops.initialselection.md) | string | _(Optional)_ |
29
- | [kind](./react/mediadeviceselectprops.kind.md) | MediaDeviceKind | |
30
- | [onActiveDeviceChange?](./react/mediadeviceselectprops.onactivedevicechange.md) | (deviceId: string) =&gt; void | _(Optional)_ |
31
- | [onDeviceListChange?](./react/mediadeviceselectprops.ondevicelistchange.md) | (devices: MediaDeviceInfo\[\]) =&gt; void | _(Optional)_ |
32
- | [onDeviceSelectError?](./react/mediadeviceselectprops.ondeviceselecterror.md) | (e: Error) =&gt; void | _(Optional)_ |
33
- | [requestPermissions?](./react/mediadeviceselectprops.requestpermissions.md) | boolean | _(Optional)_ this will call getUserMedia if the permissions are not yet given to enumerate the devices with device labels. in some browsers multiple calls to getUserMedia result in multiple permission prompts. It's generally advised only flip this to true, once a (preview) track has been acquired successfully with the appropriate permissions. |
34
- | [track?](./react/mediadeviceselectprops.track.md) | LocalAudioTrack \| LocalVideoTrack | _(Optional)_ |
25
+ {% parameter name="kind" type="MediaDeviceKind" optional=false %}
26
+ {% /parameter %}
27
+
28
+ {% parameter name="exactMatch" type="boolean" optional=true %}
29
+ _(Optional)_ will force the browser to only return the specified device will call `onDeviceSelectError` with the error in case this fails
30
+
31
+ {% /parameter %}
32
+
33
+ {% parameter name="initialSelection" type="string" optional=true %}
34
+ _(Optional)_
35
+
36
+ {% /parameter %}
37
+
38
+ {% parameter name="onActiveDeviceChange" type="(deviceId: string) => void" optional=true %}
39
+ _(Optional)_
40
+
41
+ {% /parameter %}
42
+
43
+ {% parameter name="onDeviceListChange" type="(devices: MediaDeviceInfo[]) => void" optional=true %}
44
+ _(Optional)_
45
+
46
+ {% /parameter %}
47
+
48
+ {% parameter name="onDeviceSelectError" type="(e: Error) => void" optional=true %}
49
+ _(Optional)_
50
+
51
+ {% /parameter %}
52
+
53
+ {% parameter name="requestPermissions" type="boolean" optional=true %}
54
+ _(Optional)_ this will call getUserMedia if the permissions are not yet given to enumerate the devices with device labels. in some browsers multiple calls to getUserMedia result in multiple permission prompts. It's generally advised only flip this to true, once a (preview) track has been acquired successfully with the appropriate permissions.
55
+
56
+ {% /parameter %}
57
+
58
+ {% parameter name="track" type="LocalAudioTrack | LocalVideoTrack" optional=true %}
59
+ _(Optional)_
60
+
61
+ {% /parameter %}
@@ -1,6 +1,6 @@
1
1
  <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
2
 
3
- # ParticipantAudioTile (component)
3
+ # ParticipantAudioTile
4
4
 
5
5
  The ParticipantAudioTile component is the base utility wrapper for displaying a visual representation of a participant. This component can be used as a child of the `TileLoop` or independently if a participant is passed as a property.
6
6
 
@@ -20,10 +20,27 @@ import { ParticipantAudioTile } from '@livekit/components-react';
20
20
 
21
21
  ## Properties
22
22
 
23
- | Property | Type | Description |
24
- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | ------------ |
25
- | [disableSpeakingIndicator?](./react/participanttileprops.disablespeakingindicator.md) | boolean | _(Optional)_ |
26
- | [onParticipantClick?](./react/participanttileprops.onparticipantclick.md) | (event: [ParticipantClickEvent](./core/participantclickevent.md)<!-- -->) =&gt; void | _(Optional)_ |
27
- | [participant?](./react/participanttileprops.participant.md) | Participant | _(Optional)_ |
28
- | [publication?](./react/participanttileprops.publication.md) | TrackPublication | _(Optional)_ |
29
- | [source?](./react/participanttileprops.source.md) | Track.Source | _(Optional)_ |
23
+ {% parameter name="disableSpeakingIndicator" type="boolean" optional=true %}
24
+ _(Optional)_
25
+
26
+ {% /parameter %}
27
+
28
+ {% parameter name="onParticipantClick" type="(event: ParticipantClickEvent) => void" optional=true %}
29
+ _(Optional)_
30
+
31
+ {% /parameter %}
32
+
33
+ {% parameter name="participant" type="Participant" optional=true %}
34
+ _(Optional)_
35
+
36
+ {% /parameter %}
37
+
38
+ {% parameter name="publication" type="TrackPublication" optional=true %}
39
+ _(Optional)_
40
+
41
+ {% /parameter %}
42
+
43
+ {% parameter name="source" type="Track.Source" optional=true %}
44
+ _(Optional)_
45
+
46
+ {% /parameter %}
@@ -1,6 +1,6 @@
1
1
  <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
2
 
3
- # ParticipantContextIfNeeded (component)
3
+ # ParticipantContextIfNeeded
4
4
 
5
5
  ## Import
6
6
 
@@ -1,6 +1,6 @@
1
1
  <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
2
 
3
- # ParticipantLoop (component)
3
+ # ParticipantLoop
4
4
 
5
5
  The ParticipantLoop component loops over an array of participants to create a context for every participant. This component takes exactly one child component as a template. By providing your own template as a child you have full control over the look and feel of your participant representations.
6
6
 
@@ -27,7 +27,12 @@ const participants = useParticipants();
27
27
 
28
28
  ## Properties
29
29
 
30
- | Property | Type | Description |
31
- | ------------------------------------------------------------ | --------------- | -------------------------------------------------------------------------------------------------------- |
32
- | [children](./react/participantloopprops.children.md) | React.ReactNode | The template component to be used in the loop. |
33
- | [participants](./react/participantloopprops.participants.md) | Participant\[\] | The participants to loop over. If not provided, the participants from the current room context are used. |
30
+ {% parameter name="children" type="React.ReactNode" optional=false %}
31
+ The template component to be used in the loop.
32
+
33
+ {% /parameter %}
34
+
35
+ {% parameter name="participants" type="Participant[]" optional=false %}
36
+ The participants to loop over. Use `useParticipants()` hook to get participants.
37
+
38
+ {% /parameter %}
@@ -1,6 +1,6 @@
1
1
  <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
2
 
3
- # ParticipantName (component)
3
+ # ParticipantName
4
4
 
5
5
  The ParticipantName component displays the name of the participant as a string within an HTML span element. If no participant name is undefined the participant identity string is displayed.
6
6
 
@@ -1,6 +1,6 @@
1
1
  <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
2
 
3
- # ParticipantTile (component)
3
+ # ParticipantTile
4
4
 
5
5
  The ParticipantTile component is the base utility wrapper for displaying a visual representation of a participant. This component can be used as a child of the `TrackLoop` component or by spreading a track reference as properties.
6
6
 
@@ -22,10 +22,27 @@ import { ParticipantTile } from '@livekit/components-react';
22
22
 
23
23
  ## Properties
24
24
 
25
- | Property | Type | Description |
26
- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ | ------------ |
27
- | [disableSpeakingIndicator?](./react/participanttileprops.disablespeakingindicator.md) | boolean | _(Optional)_ |
28
- | [onParticipantClick?](./react/participanttileprops.onparticipantclick.md) | (event: [ParticipantClickEvent](./core/participantclickevent.md)<!-- -->) =&gt; void | _(Optional)_ |
29
- | [participant?](./react/participanttileprops.participant.md) | Participant | _(Optional)_ |
30
- | [publication?](./react/participanttileprops.publication.md) | TrackPublication | _(Optional)_ |
31
- | [source?](./react/participanttileprops.source.md) | Track.Source | _(Optional)_ |
25
+ {% parameter name="disableSpeakingIndicator" type="boolean" optional=true %}
26
+ _(Optional)_
27
+
28
+ {% /parameter %}
29
+
30
+ {% parameter name="onParticipantClick" type="(event: ParticipantClickEvent) => void" optional=true %}
31
+ _(Optional)_
32
+
33
+ {% /parameter %}
34
+
35
+ {% parameter name="participant" type="Participant" optional=true %}
36
+ _(Optional)_
37
+
38
+ {% /parameter %}
39
+
40
+ {% parameter name="publication" type="TrackPublication" optional=true %}
41
+ _(Optional)_
42
+
43
+ {% /parameter %}
44
+
45
+ {% parameter name="source" type="Track.Source" optional=true %}
46
+ _(Optional)_
47
+
48
+ {% /parameter %}
@@ -1,6 +1,6 @@
1
1
  <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
2
 
3
- # PreJoin (prefab)
3
+ # PreJoin
4
4
 
5
5
  The PreJoin prefab component is normally presented to the user before he enters a room. This component allows the user to check and select the preferred media device (camera und microphone). On submit the user decisions are returned, which can then be passed on to the LiveKitRoom so that the user enters the room with the correct media devices.
6
6
 
@@ -24,14 +24,47 @@ This component is independent from the LiveKitRoom component and don't has to be
24
24
 
25
25
  ## Properties
26
26
 
27
- | Property | Type | Description |
28
- | ---------------------------------------------------- | ------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
29
- | [camLabel?](./react/prejoinprops.camlabel.md) | string | _(Optional)_ |
30
- | [debug?](./react/prejoinprops.debug.md) | boolean | _(Optional)_ Display a debug window for your convenience. |
31
- | [defaults?](./react/prejoinprops.defaults.md) | Partial&lt;[LocalUserChoices](./react/localuserchoices.md)<!-- -->&gt; | _(Optional)_ Prefill the input form with initial values. |
32
- | [joinLabel?](./react/prejoinprops.joinlabel.md) | string | _(Optional)_ |
33
- | [micLabel?](./react/prejoinprops.miclabel.md) | string | _(Optional)_ |
34
- | [onError?](./react/prejoinprops.onerror.md) | (error: Error) =&gt; void | _(Optional)_ |
35
- | [onSubmit?](./react/prejoinprops.onsubmit.md) | (values: [LocalUserChoices](./react/localuserchoices.md)<!-- -->) =&gt; void | _(Optional)_ This function is called with the <code>LocalUserChoices</code> if validation is passed. |
36
- | [onValidate?](./react/prejoinprops.onvalidate.md) | (values: [LocalUserChoices](./react/localuserchoices.md)<!-- -->) =&gt; boolean | _(Optional)_ Provide your custom validation function. Only if validation is successful the user choices are past to the onSubmit callback. |
37
- | [userLabel?](./react/hook/prejoinprops.userlabel.md) | string | _(Optional)_ |
27
+ {% parameter name="camLabel" type="string" optional=true %}
28
+ _(Optional)_
29
+
30
+ {% /parameter %}
31
+
32
+ {% parameter name="debug" type="boolean" optional=true %}
33
+ _(Optional)_ Display a debug window for your convenience.
34
+
35
+ {% /parameter %}
36
+
37
+ {% parameter name="defaults" type="Partial<LocalUserChoices>" optional=true %}
38
+ _(Optional)_ Prefill the input form with initial values.
39
+
40
+ {% /parameter %}
41
+
42
+ {% parameter name="joinLabel" type="string" optional=true %}
43
+ _(Optional)_
44
+
45
+ {% /parameter %}
46
+
47
+ {% parameter name="micLabel" type="string" optional=true %}
48
+ _(Optional)_
49
+
50
+ {% /parameter %}
51
+
52
+ {% parameter name="onError" type="(error: Error) => void" optional=true %}
53
+ _(Optional)_
54
+
55
+ {% /parameter %}
56
+
57
+ {% parameter name="onSubmit" type="(values: LocalUserChoices) => void" optional=true %}
58
+ _(Optional)_ This function is called with the `LocalUserChoices` if validation is passed.
59
+
60
+ {% /parameter %}
61
+
62
+ {% parameter name="onValidate" type="(values: LocalUserChoices) => boolean" optional=true %}
63
+ _(Optional)_ Provide your custom validation function. Only if validation is successful the user choices are past to the onSubmit callback.
64
+
65
+ {% /parameter %}
66
+
67
+ {% parameter name="userLabel" type="string" optional=true %}
68
+ _(Optional)_
69
+
70
+ {% /parameter %}
@@ -1,6 +1,6 @@
1
1
  <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
2
 
3
- # RoomAudioRenderer (component)
3
+ # RoomAudioRenderer
4
4
 
5
5
  The RoomAudioRenderer component is a drop-in solution for adding audio to your LiveKit app. It takes care of handling remote participants’ audio tracks and makes sure that microphones and screen share are audible.
6
6
 
@@ -1,6 +1,6 @@
1
1
  <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
2
 
3
- # RoomName (component)
3
+ # RoomName
4
4
 
5
5
  The RoomName component renders the name of the connected LiveKit room inside a span tag.
6
6
 
@@ -22,6 +22,7 @@ import { RoomName } from '@livekit/components-react';
22
22
 
23
23
  ## Properties
24
24
 
25
- | Property | Type | Description |
26
- | -------------------------------------------------------------- | ------------------- | ------------ |
27
- | [childrenPosition?](./react/roomnameprops.childrenposition.md) | 'before' \| 'after' | _(Optional)_ |
25
+ {% parameter name="childrenPosition" type="'before' | 'after'" optional=true %}
26
+ _(Optional)_
27
+
28
+ {% /parameter %}
@@ -1,6 +1,6 @@
1
1
  <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
2
 
3
- # StartAudio (component)
3
+ # StartAudio
4
4
 
5
5
  The StartAudio component is only visible when the browser blocks audio playback. This is due to some browser implemented autoplay policies. To start audio playback, the user must perform a user-initiated event such as clicking this button. As soon as audio playback starts, the button hides itself again.
6
6
 
@@ -22,6 +22,5 @@ import { StartAudio } from '@livekit/components-react';
22
22
 
23
23
  ## Properties
24
24
 
25
- | Property | Type | Description |
26
- | ------------------------------------------------- | ------ | ----------- |
27
- | [label](./react/allowaudioplaybackprops.label.md) | string | |
25
+ {% parameter name="label" type="string" optional=false %}
26
+ {% /parameter %}
@@ -1,6 +1,6 @@
1
1
  <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
2
 
3
- # Toast (component)
3
+ # Toast
4
4
 
5
5
  ## Import
6
6
 
@@ -1,6 +1,6 @@
1
1
  <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
2
 
3
- # TrackLoop (component)
3
+ # TrackLoop
4
4
 
5
5
  The TrackLoop component loops over tracks. It is for example a easy way to loop over all participant camera and screen share tracks. TrackLoop creates a TrackContext for each track that you can use to e.g. render the track.
6
6
 
@@ -25,7 +25,12 @@ const tracks = useTracks([Track.Source.Camera]);
25
25
 
26
26
  ## Properties
27
27
 
28
- | Property | Type | Description |
29
- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------- |
30
- | [children](./react/trackloopprops.children.md) | React.ReactNode | The template component to be used in the loop. |
31
- | [tracks](./react/trackloopprops.tracks.md) | [TrackReference](./core/trackreference.md)<!-- -->\[\] \| [TrackReferenceOrPlaceholder](./core/trackreferenceorplaceholder.md)<!-- -->\[\] | Track references to loop over. |
28
+ {% parameter name="children" type="React.ReactNode" optional=false %}
29
+ The template component to be used in the loop.
30
+
31
+ {% /parameter %}
32
+
33
+ {% parameter name="tracks" type="TrackReference[] | TrackReferenceOrPlaceholder[]" optional=false %}
34
+ Track references to loop over. You can the use `useTracks()` hook to get TrackReferences.
35
+
36
+ {% /parameter %}
@@ -1,6 +1,6 @@
1
1
  <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
2
 
3
- # TrackMutedIndicator (component)
3
+ # TrackMutedIndicator
4
4
 
5
5
  The TrackMutedIndicator shows whether the participant's camera or microphone is muted or not.
6
6
 
@@ -21,8 +21,15 @@ import { TrackMutedIndicator } from '@livekit/components-react';
21
21
 
22
22
  ## Properties
23
23
 
24
- | Property | Type | Description |
25
- | --------------------------------------------------------------- | -------------------------------- | ------------ |
26
- | [participant?](./react/trackmutedindicatorprops.participant.md) | Participant | _(Optional)_ |
27
- | [show?](./react/trackmutedindicatorprops.show.md) | 'always' \| 'muted' \| 'unmuted' | _(Optional)_ |
28
- | [source](./react/trackmutedindicatorprops.source.md) | Track.Source | |
24
+ {% parameter name="source" type="Track.Source" optional=false %}
25
+ {% /parameter %}
26
+
27
+ {% parameter name="participant" type="Participant" optional=true %}
28
+ _(Optional)_
29
+
30
+ {% /parameter %}
31
+
32
+ {% parameter name="show" type="'always' | 'muted' | 'unmuted'" optional=true %}
33
+ _(Optional)_
34
+
35
+ {% /parameter %}
@@ -1,6 +1,6 @@
1
1
  <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
2
 
3
- # TrackToggle (component)
3
+ # TrackToggle
4
4
 
5
5
  With the TrackToggle component it is possible to mute and unmute your camera and microphone. The component uses an html button element under the hood so you can treat it like a button.
6
6
 
@@ -23,10 +23,25 @@ import { TrackToggle } from '@livekit/components-react';
23
23
 
24
24
  ## Properties
25
25
 
26
- | Property | Type | Description |
27
- | ------------------------------------------------------------- | --------------------------------------------------------------------------- | ------------ |
28
- | [captureOptions?](./react/tracktoggleprops.captureoptions.md) | [CaptureOptionsBySource](./core/captureoptionsbysource.md)<!-- -->&lt;T&gt; | _(Optional)_ |
29
- | [initialState?](./react/tracktoggleprops.initialstate.md) | boolean | _(Optional)_ |
30
- | [onChange?](./react/tracktoggleprops.onchange.md) | (enabled: boolean) =&gt; void | _(Optional)_ |
31
- | [showIcon?](./react/tracktoggleprops.showicon.md) | boolean | _(Optional)_ |
32
- | [source](./react/tracktoggleprops.source.md) | T | |
26
+ {% parameter name="source" type="T" optional=false %}
27
+ {% /parameter %}
28
+
29
+ {% parameter name="captureOptions" type="CaptureOptionsBySource<T>" optional=true %}
30
+ _(Optional)_
31
+
32
+ {% /parameter %}
33
+
34
+ {% parameter name="initialState" type="boolean" optional=true %}
35
+ _(Optional)_
36
+
37
+ {% /parameter %}
38
+
39
+ {% parameter name="onChange" type="(enabled: boolean) => void" optional=true %}
40
+ _(Optional)_
41
+
42
+ {% /parameter %}
43
+
44
+ {% parameter name="showIcon" type="boolean" optional=true %}
45
+ _(Optional)_
46
+
47
+ {% /parameter %}
@@ -1,6 +1,6 @@
1
1
  <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
2
 
3
- # VideoConference (prefab)
3
+ # VideoConference
4
4
 
5
5
  This component is the default setup of a classic LiveKit video conferencing app. It provides functionality like switching between participant grid view and focus view.
6
6
 
@@ -26,6 +26,17 @@ The component is implemented with other LiveKit components like `FocusContextPro
26
26
 
27
27
  ## Properties
28
28
 
29
- | Property | Type | Description |
30
- | ----------------------------------------------------------------------------- | ----------------------------------------------- | ------------ |
31
- | [chatMessageFormatter?](./react/videoconferenceprops.chatmessageformatter.md) | [MessageFormatter](./react/messageformatter.md) | _(Optional)_ |
29
+ {% parameter name="chatMessageDecoder" type="MessageDecoder" optional=true %}
30
+ _(Optional)_
31
+
32
+ {% /parameter %}
33
+
34
+ {% parameter name="chatMessageEncoder" type="MessageEncoder" optional=true %}
35
+ _(Optional)_
36
+
37
+ {% /parameter %}
38
+
39
+ {% parameter name="chatMessageFormatter" type="MessageFormatter" optional=true %}
40
+ _(Optional)_
41
+
42
+ {% /parameter %}
@@ -1,6 +1,6 @@
1
1
  <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
2
 
3
- # VideoTrack (component)
3
+ # VideoTrack
4
4
 
5
5
  The VideoTrack component is responsible for rendering participant video tracks like `camera` and `screen_share`<!-- -->. This component must have access to the participant's context, or alternatively pass it a `Participant` as a property.
6
6
 
@@ -20,11 +20,35 @@ import { VideoTrack } from '@livekit/components-react';
20
20
 
21
21
  ## Properties
22
22
 
23
- | Property | Type | Description |
24
- | -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | ------------ |
25
- | [name?](./react/videotrackprops.name.md) | string | _(Optional)_ |
26
- | [onSubscriptionStatusChanged?](./react/videotrackprops.onsubscriptionstatuschanged.md) | (subscribed: boolean) =&gt; void | _(Optional)_ |
27
- | [onTrackClick?](./react/videotrackprops.ontrackclick.md) | (evt: [ParticipantClickEvent](./core/participantclickevent.md)<!-- -->) =&gt; void | _(Optional)_ |
28
- | [participant?](./react/videotrackprops.participant.md) | Participant | _(Optional)_ |
29
- | [publication?](./react/videotrackprops.publication.md) | TrackPublication | _(Optional)_ |
30
- | [source](./react/videotrackprops.source.md) | Track.Source | |
23
+ {% parameter name="source" type="Track.Source" optional=false %}
24
+ {% /parameter %}
25
+
26
+ {% parameter name="manageSubscription" type="boolean" optional=true %}
27
+ _(Optional)_
28
+
29
+ {% /parameter %}
30
+
31
+ {% parameter name="name" type="string" optional=true %}
32
+ _(Optional)_
33
+
34
+ {% /parameter %}
35
+
36
+ {% parameter name="onSubscriptionStatusChanged" type="(subscribed: boolean) => void" optional=true %}
37
+ _(Optional)_
38
+
39
+ {% /parameter %}
40
+
41
+ {% parameter name="onTrackClick" type="(evt: ParticipantClickEvent) => void" optional=true %}
42
+ _(Optional)_
43
+
44
+ {% /parameter %}
45
+
46
+ {% parameter name="participant" type="Participant" optional=true %}
47
+ _(Optional)_
48
+
49
+ {% /parameter %}
50
+
51
+ {% parameter name="publication" type="TrackPublication" optional=true %}
52
+ _(Optional)_
53
+
54
+ {% /parameter %}
@@ -1,6 +1,6 @@
1
1
  <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
2
 
3
- # useChat (hook)
3
+ # useChat
4
4
 
5
5
  ## Import
6
6
 
@@ -10,6 +10,14 @@ import { useChat } from '@livekit/components-react';
10
10
 
11
11
  {% partial file="p_usage.md" /%}
12
12
 
13
- **Returns:**
13
+ ## Parameters
14
14
 
15
- { send: ((message: string) =&gt; Promise&lt;void&gt;) \| undefined; chatMessages: [ReceivedChatMessage](./core/receivedchatmessage.md)<!-- -->\[\]; isSending: boolean; }
15
+ {% parameter name="options" type="{
16
+ messageEncoder?: MessageEncoder;
17
+ messageDecoder?: MessageDecoder;
18
+ }" optional=true %}
19
+ {% /parameter %}
20
+
21
+ ## Returns
22
+
23
+ `{ send: ((message: string) => Promise<void>) | undefined; chatMessages: ReceivedChatMessage[]; isSending: boolean; }`
@@ -1,6 +1,6 @@
1
1
  <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
2
 
3
- # useChatToggle (hook)
3
+ # useChatToggle
4
4
 
5
5
  ## Import
6
6
 
@@ -12,10 +12,9 @@ import { useChatToggle } from '@livekit/components-react';
12
12
 
13
13
  ## Parameters
14
14
 
15
- | Parameter | Type | Description |
16
- | --------- | --------------------------------------------------- | ----------- |
17
- | { props } | [UseChatToggleProps](./react/usechattoggleprops.md) | |
15
+ {% parameter name="{ props }" type="UseChatToggleProps" optional=false %}
16
+ {% /parameter %}
18
17
 
19
- **Returns:**
18
+ ## Returns
20
19
 
21
- { mergedProps: React.ButtonHTMLAttributes&lt;HTMLButtonElement&gt; &amp; { className: string; onClick: () =&gt; void; 'aria-pressed': string; 'data-lk-unread-msgs': string; }; }
20
+ `{ mergedProps: React.ButtonHTMLAttributes<HTMLButtonElement> & { className: string; onClick: () => void; 'aria-pressed': string; 'data-lk-unread-msgs': string; }; }`
@@ -1,6 +1,6 @@
1
1
  <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
2
 
3
- # useClearPinButton (hook)
3
+ # useClearPinButton
4
4
 
5
5
  ## Import
6
6
 
@@ -12,10 +12,9 @@ import { useClearPinButton } from '@livekit/components-react';
12
12
 
13
13
  ## Parameters
14
14
 
15
- | Parameter | Type | Description |
16
- | --------- | ----------------------------------------------------- | ----------- |
17
- | props | [ClearPinButtonProps](./react/clearpinbuttonprops.md) | |
15
+ {% parameter name="props" type="ClearPinButtonProps" optional=false %}
16
+ {% /parameter %}
18
17
 
19
- **Returns:**
18
+ ## Returns
20
19
 
21
- { buttonProps: [ClearPinButtonProps](./react/clearpinbuttonprops.md) &amp; { className: string; disabled: boolean; onClick: () =&gt; void; }; }
20
+ `{ buttonProps: ClearPinButtonProps & { className: string; disabled: boolean; onClick: () => void; }; }`
@@ -1,6 +1,6 @@
1
1
  <!-- Do not edit this file. It is automatically generated by API Documenter. -->
2
2
 
3
- # useConnectionQualityIndicator (hook)
3
+ # useConnectionQualityIndicator
4
4
 
5
5
  ## Import
6
6
 
@@ -12,10 +12,9 @@ import { useConnectionQualityIndicator } from '@livekit/components-react';
12
12
 
13
13
  ## Parameters
14
14
 
15
- | Parameter | Type | Description |
16
- | --------- | --------------------------------------------------------------------------------- | ------------ |
17
- | options | [ConnectionQualityIndicatorOptions](./react/connectionqualityindicatoroptions.md) | _(Optional)_ |
15
+ {% parameter name="options" type="ConnectionQualityIndicatorOptions" optional=true %}
16
+ {% /parameter %}
18
17
 
19
- **Returns:**
18
+ ## Returns
20
19
 
21
- { className: "lk-rotate" \| "lk-audio-conference" \| "lk-audio-conference-stage" \| "lk-audio-container" \| "lk-button" \| "lk-button-group" \| "lk-button-group-container" \| "lk-camera-off-note" \| "lk-chat" \| "lk-chat-entry" \| "lk-chat-form" \| "lk-chat-form-input" \| "lk-chat-messages" \| "lk-control-bar" \| "lk-focus-layout-wrapper" \| "lk-form-control" \| "lk-grid-layout-wrapper" \| "lk-join-button" \| "lk-list" \| "lk-message-body" \| "lk-meta-data" \| "lk-participant-name" \| "lk-prejoin" \| "lk-timestamp" \| "lk-username-container" \| "lk-video-conference" \| "lk-video-conference-inner" \| "lk-video-container" \| "lk-audio-visualizer" \| "lk-button-group-menu" \| "lk-button-menu" \| "lk-carousel" \| "lk-chat-toggle" \| "lk-connection-quality" \| "lk-device-menu" \| "lk-device-menu-heading" \| "lk-disconnect-button" \| "lk-focus-layout" \| "lk-focus-toggle-button" \| "lk-focused-participant" \| "lk-grid-layout" \| "lk-media-device-select" \| "lk-pagination-control" \| "lk-pagination-count" \| "lk-pagination-indicator" \| "lk-participant-media-audio" \| "lk-participant-media-video" \| "lk-participant-metadata" \| "lk-participant-metadata-item" \| "lk-participant-placeholder" \| "lk-participant-tile" \| "lk-pip-track" \| "lk-room-container" \| "lk-spinner" \| "lk-start-audio-button" \| "lk-toast" \| "lk-track-muted-indicator-camera" \| "lk-track-muted-indicator-microphone"; quality: ConnectionQuality; }
20
+ `{ className: "lk-rotate" | "lk-audio-conference" | "lk-audio-conference-stage" | "lk-audio-container" | "lk-button" | "lk-button-group" | "lk-button-group-container" | "lk-camera-off-note" | "lk-chat" | "lk-chat-entry" | "lk-chat-form" | "lk-chat-form-input" | "lk-chat-messages" | "lk-control-bar" | "lk-focus-layout-wrapper" | "lk-form-control" | "lk-grid-layout-wrapper" | "lk-join-button" | "lk-list" | "lk-message-body" | "lk-meta-data" | "lk-participant-name" | "lk-prejoin" | "lk-timestamp" | "lk-username-container" | "lk-video-conference" | "lk-video-conference-inner" | "lk-video-container" | "lk-audio-visualizer" | "lk-button-group-menu" | "lk-button-menu" | "lk-carousel" | "lk-chat-toggle" | "lk-connection-quality" | "lk-device-menu" | "lk-device-menu-heading" | "lk-disconnect-button" | "lk-focus-layout" | "lk-focus-toggle-button" | "lk-focused-participant" | "lk-grid-layout" | "lk-media-device-select" | "lk-pagination-control" | "lk-pagination-count" | "lk-pagination-indicator" | "lk-participant-media-audio" | "lk-participant-media-video" | "lk-participant-metadata" | "lk-participant-metadata-item" | "lk-participant-placeholder" | "lk-participant-tile" | "lk-pip-track" | "lk-room-container" | "lk-spinner" | "lk-start-audio-button" | "lk-toast" | "lk-track-muted-indicator-camera" | "lk-track-muted-indicator-microphone"; quality: ConnectionQuality; }`