IParentalControlsComponentV2
This is the top-level component used for interfacing with parental controls.
IParentalControlsComponentV2 is an experimental extension of IParentalControlsComponent
that grants access to IParentalControlsPreferenceWriter and the generic PIN challenge
workflow: invokeValidatePinWorkflow.
Extends
Extended by
Methods
gateContentPlayback()
gateContentPlayback(
contentRating?):Promise<IGateContentPlaybackResponse>
Parameters
contentRating?
IContentRating
rating for the content that is a candidate for playback. This field is optional and may be ommitted such as in the case that ratings information is unavailable; in that case parental controls will require a PIN challenge irrespective of the current restriction level.
Returns
Promise<IGateContentPlaybackResponse>
a Promise that resolves to an IGateContentPlaybackResponse indicating the outcome of the request (and PIN challenge if it was required).
Brief
Invoke PIN challenge for viewing potentially restricted content.
This method delegates to parental controls to decide whether a PIN challenge is required before permitting the viewing of content with the passed rating information. The ratings parameter is optional; if ratings information is not supplied (such as in the case that it is not available) this method defaults to requiring the PIN challenge.
If the rating information passed is more restrictive than permitted by the current restriction level preference, this method will present a PIN challenge to the user in the form of an unescapable modal dialog; that is, the user must either successfully validate their PIN or cancel the validation. Attempts to navigate away from the PIN challenge (such as by pressing back or a provider shortcut on the remote) will implicitly cancel PIN validation. The action that should be taken by the caller is relayed in the resolved IGateContentPlaybackResponse#canPlaybackProceed value.
The returned Promise is resolved once the request has been resolved by parental controls (either because the PIN challenge was successfully validated or was unnecessary). The modal dialog has no timeout, so integrators should take into account that the Promise may not be resolved immediately. The parental controls dialog will remain in the foreground (as an overlay over the calling app) until it is resolved.
Pre
caller requires privilege
com.amazon.kepler.parental_controls.gates.restricted-content-playback
to invoke this method.
Pre
caller must be an interactive application that is presently running in the foreground.
Inherited from
IParentalControlsComponent.gateContentPlayback
getMajorVersion()
getMajorVersion():
number
Returns
number
Overrides
IParentalControlsComponent.getMajorVersion
getMinorVersion()
getMinorVersion():
number
Returns
number
Overrides
IParentalControlsComponent.getMinorVersion
getPatchVersion()
getPatchVersion():
number
Returns
number
Overrides
IParentalControlsComponent.getPatchVersion
invokeValidatePinWorkflow()
invokeValidatePinWorkflow():
Promise<IValidatePinResponse>
Returns
Promise<IValidatePinResponse>
an instance of ISubscription that can be used to cancel the listener from being called back and associate request context to the callback.
Brief
Invoke a general-purpose PIN challenge workflow for gating a restricted user action.
This method will present a PIN challenge to the user in the form of an unescapable modal dialog; that is, the user must either successfully validate their PIN or cancel the validation. Attempts to navigate away from the PIN challenge (such as by pressing back or a provider shortcut on the remote) will implicitly cancel PIN validation. The action that should be taken by the caller is relayed in the IValidatePinResponse#isPinValid value passed to the IValidatePinListener.
The PIN is not passed to this method, but rather collected from the user directly using the modal dialog.
The {@ref IValidatePinListener} listener is invoked once the request has been resolved by parental controls (either because the PIN challenge was successfully validated or was unnecessary). The modal dialog has no timeout, so integrators should take into account that the listener may not be invoked immediately. The parental controls dialog will remain in the foreground (as an overlay over the calling app) until it is resolved.
Pre
caller requires privilege
com.amazon.kepler.parental_controls.gates.validate-pin to invoke this
method.
Pre
caller must be an interactive application that is presently running in the foreground.
makePreferenceReader()
makePreferenceReader():
IParentalControlsPreferenceReader
Construct an IParentalControlsPreferenceReader object, used for getting the current state of Parental Controls preference settings and determining whether Parental Controls is enabled.
Returns
IParentalControlsPreferenceReader
Inherited from
IParentalControlsComponent.makePreferenceReader
makePreferenceWriter()
makePreferenceWriter():
IParentalControlsPreferenceWriter
Construct an IParentalControlsPreferenceWriter object, used for setting the current state of Parental Controls preference settings and invoking the Parental Controls enablement workflow.
Returns
IParentalControlsPreferenceWriter
Last updated: Sep 30, 2025
