Call Transcript

API and Development

View SourceOpens in a new tab Submit IssueOpens in a new tab

Prop	Type	Default	Notes
`rows`	`readonly CallTranscriptRow[]`	required	The call's lines, oldest first
`copy`	`CallTranscriptCopy`	required	Every string, typed `LocalizedMessage`
`audioClips`	`readonly AudioPlayerClip[]`		The recording; enables the player and the jump action
`highlightTerm`	`string`		Case-insensitive text marked in every row
`languages`	`CallTranscriptLanguage[]`		The languages in the language menu; with `copy.language` it draws the language control
`language`	`string`		The language the reader chose, by code; undefined means detection is in charge
`detectedLanguage`	`string`		The language the host detected, by code
`isDetectingLanguage`	`boolean`		The host is still detecting; the control says so and is disabled
`onLanguageChange`	`(language, details) => void`		Called with the chosen code, or `undefined` for detection
`navigationTarget`	`CallTranscriptNavigationTarget`		Controlled request to move to a row; applied when `requestId` changes
`skipInterval`	`number`		Milliseconds the audio bar's skip buttons move
`timeDisplayMode`	`TimeDisplayMode`		How the audio bar arranges time
`locale`	`string`		BCP 47 locale the audio bar formats and speaks time in
`emptyContent`	`ReactNode`		Replaces the empty state
`liveGuidance`	`ReactNode`		A `LiveGuidance` panel that floats under the rows, above the composer; the rows scroll and fade behind it
`composer`	`ReactNode`		The chat input, floating under the rows below the live guidance
`onNavigate`	`(event: CallTranscriptNavigationEvent) => void`		The reader jumped from a row to its moment in the audio
`onReportIssue`	`(row: CallTranscriptRow) => void`		Adds the report action to every row
`onTimeChange`	`(timeMs: number) => void`		The playhead moved
`onPlayingChange`	`(playing: boolean) => void`		Playback started or stopped
`className`	`string`		Appended to the root
`id`	`string`		Root id
`ref`	`Ref<HTMLDivElement>`		Root element

Rows

Field	Type	Notes
`id`	`string`	Stable; the row's key and `navigationTarget.messageId`
`timestampMs`	`number`	Absolute milliseconds, on the audio's timeline
`dateTime`	`string`	ISO 8601 with an offset
`text`	`string`	The words as stored
`speaker`	`CallTranscriptSpeaker`	`side` is `Calltaker` or `Caller`; the host attributes speakers
`translation`	`CallTranscriptTranslation`	Without it the row draws one bubble
`sourceFragments`	`readonly CallTranscriptSourceFragment[]`	The fragments a merged row is built from

Constants

Name	Value	Notes
`CALL_TRANSCRIPT_ACTIVE_WINDOW_MS`	2000	A row is active within this many milliseconds of the playhead
`CALL_TRANSCRIPT_ESTIMATED_ROW_SIZE`	80	Pixels reserved for a row not yet laid out
`CALL_TRANSCRIPT_JUMP_HIGHLIGHT_MS`	2000	How long a keyword jump keeps its highlight

Development

Imports are limited to what schema.ts composes (block-composition test). Every consumer callback goes through callConsumerHandler. The contract and its decisions are in CONTRACT.md.

Call Transcript / Usage

Call Transcript / Accessibility

On this page

Rows

Constants

Development

Call Transcript

API and Development

View SourceOpens in a new tab Submit IssueOpens in a new tab

Prop	Type	Default	Notes
`rows`	`readonly CallTranscriptRow[]`	required	The call's lines, oldest first
`copy`	`CallTranscriptCopy`	required	Every string, typed `LocalizedMessage`
`audioClips`	`readonly AudioPlayerClip[]`		The recording; enables the player and the jump action
`highlightTerm`	`string`		Case-insensitive text marked in every row
`languages`	`CallTranscriptLanguage[]`		The languages in the language menu; with `copy.language` it draws the language control
`language`	`string`		The language the reader chose, by code; undefined means detection is in charge
`detectedLanguage`	`string`		The language the host detected, by code
`isDetectingLanguage`	`boolean`		The host is still detecting; the control says so and is disabled
`onLanguageChange`	`(language, details) => void`		Called with the chosen code, or `undefined` for detection
`navigationTarget`	`CallTranscriptNavigationTarget`		Controlled request to move to a row; applied when `requestId` changes
`skipInterval`	`number`		Milliseconds the audio bar's skip buttons move
`timeDisplayMode`	`TimeDisplayMode`		How the audio bar arranges time
`locale`	`string`		BCP 47 locale the audio bar formats and speaks time in
`emptyContent`	`ReactNode`		Replaces the empty state
`liveGuidance`	`ReactNode`		A `LiveGuidance` panel that floats under the rows, above the composer; the rows scroll and fade behind it
`composer`	`ReactNode`		The chat input, floating under the rows below the live guidance
`onNavigate`	`(event: CallTranscriptNavigationEvent) => void`		The reader jumped from a row to its moment in the audio
`onReportIssue`	`(row: CallTranscriptRow) => void`		Adds the report action to every row
`onTimeChange`	`(timeMs: number) => void`		The playhead moved
`onPlayingChange`	`(playing: boolean) => void`		Playback started or stopped
`className`	`string`		Appended to the root
`id`	`string`		Root id
`ref`	`Ref<HTMLDivElement>`		Root element

Rows

Field	Type	Notes
`id`	`string`	Stable; the row's key and `navigationTarget.messageId`
`timestampMs`	`number`	Absolute milliseconds, on the audio's timeline
`dateTime`	`string`	ISO 8601 with an offset
`text`	`string`	The words as stored
`speaker`	`CallTranscriptSpeaker`	`side` is `Calltaker` or `Caller`; the host attributes speakers
`translation`	`CallTranscriptTranslation`	Without it the row draws one bubble
`sourceFragments`	`readonly CallTranscriptSourceFragment[]`	The fragments a merged row is built from

Constants

Name	Value	Notes
`CALL_TRANSCRIPT_ACTIVE_WINDOW_MS`	2000	A row is active within this many milliseconds of the playhead
`CALL_TRANSCRIPT_ESTIMATED_ROW_SIZE`	80	Pixels reserved for a row not yet laid out
`CALL_TRANSCRIPT_JUMP_HIGHLIGHT_MS`	2000	How long a keyword jump keeps its highlight

Development

Imports are limited to what schema.ts composes (block-composition test). Every consumer callback goes through callConsumerHandler. The contract and its decisions are in CONTRACT.md.

Call Transcript / Usage

Call Transcript / Accessibility

On this page

Rows

Constants

Development