Brief
This is a react native component that closed captions and subtitles on the screen. Use the component only when operating in pre-buffering mode usingVideoPlayer
and AudioPlayer components.
Apps attach the captions handle passed by onCaptionViewCreated event callback to
the VideoPlayer & AudioPlayer by calling the setCaptionViewHandle function so that
the player is able to render captions or subtitles on screen.
Extends
Component<CaptionViewProps>
Constructors
new KeplerCaptionsView()
new KeplerCaptionsView(props): KeplerCaptionsView
Parameters
props
CaptionViewProps
Returns
KeplerCaptionsView
Overrides
Properties
context
context:unknown
If using the new style context, re-declare this in your class to be the
React.ContextType of your static contextType.
Should be used with type annotation or static contextType.
Example
See
React DocsInherited from
React.Component.context
props
readonly props: Readonly<CaptionViewProps>
Inherited from
React.Component.props
refs
refs: object
Index Signature
Deprecated
See
Legacy React DocsInherited from
React.Component.refs
state
state:Readonly<{}>
Inherited from
React.Component.state
contextType?
static optional contextType: Context<any>
If set, this.context will be set at runtime to the current value of the given Context.
Example
See
https://react.dev/reference/react/Component#static-contexttypeInherited from
React.Component.contextType
Methods
componentDidCatch()?
optional componentDidCatch(error, errorInfo): void
Catches exceptions generated in descendant components. Unhandled exceptions will cause
the entire component tree to unmount.
Parameters
error
Error
errorInfo
ErrorInfo
Returns
void
Inherited from
React.Component.componentDidCatch
componentDidUpdate()?
optional componentDidUpdate(prevProps, prevState, snapshot?): void
Called immediately after updating occurs. Not called for the initial render.
The snapshot is only present if getSnapshotBeforeUpdate is present and returns non-null.
Parameters
prevProps
Readonly<CaptionViewProps>
prevState
Readonly<{}>
snapshot?
any
Returns
void
Inherited from
React.Component.componentDidUpdate
componentWillMount()?
optional componentWillMount(): void
Called immediately before mounting occurs, and before Component.render.
Avoid introducing any side-effects or subscriptions in this method.
Note: the presence of NewLifecycle.getSnapshotBeforeUpdate getSnapshotBeforeUpdate
or StaticLifecycle.getDerivedStateFromProps getDerivedStateFromProps prevents
this from being invoked.
Returns
void
Deprecated
16.3, use ComponentLifecycle.componentDidMount componentDidMount or the constructor instead; will stop working in React 17See
- https://legacy.reactjs.org/blog/2018/03/27/update-on-async-rendering.html#initializing-state
- https://legacy.reactjs.org/blog/2018/03/27/update-on-async-rendering.html#gradual-migration-path
Inherited from
React.Component.componentWillMount
componentWillReceiveProps()?
optional componentWillReceiveProps(nextProps, nextContext): void
Called when the component may be receiving new props.
React may call this even if props have not changed, so be sure to compare new and existing
props if you only want to handle changes.
Calling Component.setState generally does not trigger this method.
Note: the presence of NewLifecycle.getSnapshotBeforeUpdate getSnapshotBeforeUpdate
or StaticLifecycle.getDerivedStateFromProps getDerivedStateFromProps prevents
this from being invoked.
Parameters
nextProps
Readonly<CaptionViewProps>
nextContext
any
Returns
void
Deprecated
16.3, use static StaticLifecycle.getDerivedStateFromProps getDerivedStateFromProps instead; will stop working in React 17See
- https://legacy.reactjs.org/blog/2018/03/27/update-on-async-rendering.html#updating-state-based-on-props
- https://legacy.reactjs.org/blog/2018/03/27/update-on-async-rendering.html#gradual-migration-path
Inherited from
React.Component.componentWillReceiveProps
componentWillUpdate()?
optional componentWillUpdate(nextProps, nextState, nextContext): void
Called immediately before rendering when new props or state is received. Not called for the initial render.
Note: You cannot call Component.setState here.
Note: the presence of NewLifecycle.getSnapshotBeforeUpdate getSnapshotBeforeUpdate
or StaticLifecycle.getDerivedStateFromProps getDerivedStateFromProps prevents
this from being invoked.
Parameters
nextProps
Readonly<CaptionViewProps>
nextState
Readonly<{}>
nextContext
any
Returns
void
Deprecated
16.3, use getSnapshotBeforeUpdate instead; will stop working in React 17See
- https://legacy.reactjs.org/blog/2018/03/27/update-on-async-rendering.html#reading-dom-properties-before-an-update
- https://legacy.reactjs.org/blog/2018/03/27/update-on-async-rendering.html#gradual-migration-path
Inherited from
React.Component.componentWillUpdate
forceUpdate()
forceUpdate(callback?): void
Parameters
callback?
() =>void
Returns
void
Inherited from
React.Component.forceUpdate
getSnapshotBeforeUpdate()?
optional getSnapshotBeforeUpdate(prevProps, prevState): any
Runs before React applies the result of Component.render render to the document, and
returns an object to be given to componentDidUpdate. Useful for saving
things such as scroll position before Component.render render causes changes to it.
Note: the presence of this method prevents any of the deprecated
lifecycle events from running.
Parameters
prevProps
Readonly<CaptionViewProps>
prevState
Readonly<{}>
Returns
any
Inherited from
React.Component.getSnapshotBeforeUpdate
setState()
setState<K>(state, callback?): void
Type Parameters
• K extendsnever
Parameters
state
callback?
() =>void
Returns
void
Inherited from
React.Component.setState
shouldComponentUpdate()?
optional shouldComponentUpdate(nextProps, nextState, nextContext): boolean
Called to determine whether the change in props and state should trigger a re-render.
Component always returns true.
PureComponent implements a shallow comparison on props and state and returns true if any
props or states have changed.
If false is returned, Component.render, componentWillUpdate
and componentDidUpdate will not be called.
Parameters
nextProps
Readonly<CaptionViewProps>
nextState
Readonly<{}>
nextContext
any
Returns
boolean
Inherited from
React.Component.shouldComponentUpdate
UNSAFE_componentWillMount()?
optional UNSAFE_componentWillMount(): void
Called immediately before mounting occurs, and before Component.render.
Avoid introducing any side-effects or subscriptions in this method.
This method will not stop working in React 17.
Note: the presence of NewLifecycle.getSnapshotBeforeUpdate getSnapshotBeforeUpdate
or StaticLifecycle.getDerivedStateFromProps getDerivedStateFromProps prevents
this from being invoked.
Returns
void
Deprecated
16.3, use ComponentLifecycle.componentDidMount componentDidMount or the constructor insteadSee
- https://legacy.reactjs.org/blog/2018/03/27/update-on-async-rendering.html#initializing-state
- https://legacy.reactjs.org/blog/2018/03/27/update-on-async-rendering.html#gradual-migration-path
Inherited from
React.Component.UNSAFE_componentWillMount
UNSAFE_componentWillReceiveProps()?
optional UNSAFE_componentWillReceiveProps(nextProps, nextContext): void
Called when the component may be receiving new props.
React may call this even if props have not changed, so be sure to compare new and existing
props if you only want to handle changes.
Calling Component.setState generally does not trigger this method.
This method will not stop working in React 17.
Note: the presence of NewLifecycle.getSnapshotBeforeUpdate getSnapshotBeforeUpdate
or StaticLifecycle.getDerivedStateFromProps getDerivedStateFromProps prevents
this from being invoked.
Parameters
nextProps
Readonly<CaptionViewProps>
nextContext
any
Returns
void
Deprecated
16.3, use static StaticLifecycle.getDerivedStateFromProps getDerivedStateFromProps insteadSee
- https://legacy.reactjs.org/blog/2018/03/27/update-on-async-rendering.html#updating-state-based-on-props
- https://legacy.reactjs.org/blog/2018/03/27/update-on-async-rendering.html#gradual-migration-path
Inherited from
React.Component.UNSAFE_componentWillReceiveProps
UNSAFE_componentWillUpdate()?
optional UNSAFE_componentWillUpdate(nextProps, nextState, nextContext): void
Called immediately before rendering when new props or state is received. Not called for the initial render.
Note: You cannot call Component.setState here.
This method will not stop working in React 17.
Note: the presence of NewLifecycle.getSnapshotBeforeUpdate getSnapshotBeforeUpdate
or StaticLifecycle.getDerivedStateFromProps getDerivedStateFromProps prevents
this from being invoked.
Parameters
nextProps
Readonly<CaptionViewProps>
nextState
Readonly<{}>
nextContext
any
Returns
void
Deprecated
16.3, use getSnapshotBeforeUpdate insteadSee
- https://legacy.reactjs.org/blog/2018/03/27/update-on-async-rendering.html#reading-dom-properties-before-an-update
- https://legacy.reactjs.org/blog/2018/03/27/update-on-async-rendering.html#gradual-migration-path
Inherited from
React.Component.UNSAFE_componentWillUpdate

