Valora
API Reference@valora-ai/reactindexFunctions

useMaybeTrackRefContext

function useMaybeTrackRefContext(): unknown;

Defined in: packages/react/src/hooks/track/useMaybeTrackRefContext.ts:33

Returns a track reference from the TrackRefContext if it exists, otherwise undefined.

Returns

unknown

Example

// Basic — read an optional track reference from context.
const trackRef = useMaybeTrackRefContext();

// Advanced — pass a track-loop context into a custom tile.
function TrackTileFromContext() {
  const trackRef = useMaybeTrackRefContext();

  return trackRef ? <ParticipantTile trackRef={trackRef} /> : null;
}

function CameraGrid() {
  const tracks = useTracks([{ source: Track.Source.Camera, withPlaceholder: true }]);
  return <TrackLoop tracks={tracks}><TrackTileFromContext /></TrackLoop>;
}

function App() {
  return <VoiceRoom agent={agent}><CameraGrid /></VoiceRoom>;
}

On this page

Valora is local-first

No API key, no server — everything in this doc runs on-device.

Star on GitHub