You.i Engine
CYICloudInterface Class Referenceabstract

Detailed Description

The cloud interface provides a binding to the Cloud SDK.

On non-cloud builds, an CYICloudInterface interface (NOP) will be returned. On cloud builds, the interface will forward function calls to the Cloud SDK.

#include <YiCloudInterface.h>

Inheritance diagram for CYICloudInterface:

Public Types

enum  InterfaceType {
  InterfaceType::NULL_INTERFACE,
  InterfaceType::ROKU_INTERFACE,
  InterfaceType::WEB_INTERFACE
}
 
enum  ListIncomingFocusStyle {
  ListIncomingFocusStyle::CLOSEST,
  ListIncomingFocusStyle::PREVIOUS_ITEM
}
 
enum  ListOutgoingFocusStyle {
  ListOutgoingFocusStyle::CLOSEST,
  ListOutgoingFocusStyle::CLOSEST_TO_LIST
}
 

Public Member Functions

 CYICloudInterface ()=default
 
virtual ~CYICloudInterface ()
 
virtual bool Init (CYIApp *pApp)=0
 Initialize the cloud sdk. More...
 
virtual bool RunMainLoop ()=0
 Run the CYIApp main loop. More...
 
virtual bool Begin ()=0
 Begin listening for client connection. More...
 
virtual void Shutdown ()=0
 Shutdown the cloud sdk. More...
 
virtual bool IsCloudServer ()=0
 Returns true if the implementation is a cloud server. More...
 
virtual void ExportStagedScenes ()=0
 Export all staged scenes. This is executed immediately. More...
 
virtual void SetUseNullRenderer (bool useNull)=0
 Enable or disable the use of the null renderer. More...
 
virtual bool IsUsingNullRenderer () const =0
 Return true if the cloud sdk is using the null renderer. More...
 
virtual bool SendFocusMap (CYISceneManager *pSceneManager=nullptr)=0
 Send a generated focus map to the client. More...
 
virtual bool SetExportHint (CYISceneNode *pNode, const CYIString &hintName, const CYIAny &value)=0
 Apply the given export hint to a scene node. More...
 
virtual void SetIncomingFocusStyle (CYIListView *pList, ListIncomingFocusStyle focusStyle)=0
 Used to set up how focus will be calculated when list recieves focus from another item. More...
 
virtual void SetOutgoingFocusStyle (CYIListView *pList, ListOutgoingFocusStyle focusStyle)=0
 Used to set up how focus will be calculated when list recieves focus from another item. More...
 
virtual void SetInitalScrollIndexWithFocus (CYIListView *pList, uint32_t index)=0
 Call setInitalScrollIndexWithFocus to set the initial scroll index of the list. This method will also set focus to the corresponding list item. It this API called in a react native application, it should be called via onLoad. Please do not call this method from other RN life cycle methods as this can cause incorrect application behaviour (The focus request is delayed until after the client receives the new scene graph update). More...
 
virtual bool SetVideoMetadata (CYIAbstractVideoPlayer *pVideoPlayer, const CYIAbstractVideoPlayer::VideoMetadata &metadata)=0
 Add video data such as videoUrl, title, contentId (required for player analytics) More...
 
virtual const CYIClientPlayer::PlaybackSessionInfoGetLastPlaybackSessionInfo () const =0
 Get the recently updated playback session information such as bookmark and audio/cc settings. More...
 
virtual void EnableLayoutExport (bool enable)=0
 Enable export of layout properties into Roku's layout system instead of exporting the results of the You.i Engine layout system. Roku layouts support less features, but their advantage is that they will respond to content changes after export. More...
 
virtual void SetFocusOnSceneNode (const CYISceneNode *pNode)=0
 Set client focus on the specified scene node. More...
 
virtual void ClearClientFocus ()=0
 Clear the client's focus. The server will then push its own focus state once a view has focus. More...
 
virtual void InvokeCommand (const CYIString cmd, const CYIBundle &args=CYIBundle(), std::function< void(bool, CYIBundle)> callback=nullptr)=0
 Invoke custom client command. More...
 
virtual bool IsLowEndDevice ()=0
 Returns true if the device is low end. More...
 
virtual const CYIStringGetClientExternalIp () const =0
 Return the external IP of the client. More...
 
virtual void TerminateApplication ()=0
 Terminate the Application and return to the home screen. More...
 
virtual void ScrollListToIndex (CYISceneNode *pListNode, uint32_t index)=0
 Scroll the list item in the specified list at the specified index into view. More...
 
virtual void ShowWaitSpinnerNow ()=0
 Show the wait spinner right away. More...
 
virtual void SetSpinnerDelayMs (uint32_t delayMs)=0
 Sets the time of spinner delay in milliseconds. More...
 
virtual void ShowWaitSpinner ()=0
 Show the wait spinner with configured delay. More...
 
virtual void HideWaitSpinner ()=0
 Hide the wait spinner. More...
 
virtual void AddModalScene (const CYIString &name, const CYISceneNode *pSceneNode, int32_t layerIndex=0, std::set< CYIString > associatedScenes=std::set< CYIString >())=0
 Identify overlay scene to be exported with initial components. More...
 
virtual void RemoveModalScene (const CYIString &name)=0
 Remove an overlay scene from the set of registered modals. More...
 
virtual void SendUpdatedListItemField (CYISceneView *pList, const std::map< CYISceneNode *, CYIString > &updateMap, const int32_t itemIndex)=0
 Update fields on a given list item. The updateMap contains the list item view to update and the new value (i.e. text field, uri). . More...
 
virtual void SendScrollToNode (const CYISceneView *pScrollingView, const CYISceneNode *pNode)=0
 Scroll the given scrolling view to the provided node. More...
 
virtual void SendScrollingTextViewUpdate (const CYISceneNode *pScrollingTextView, const CYIString &text, const CYIString &title)=0
 Update the text for a scrolling text view. More...
 
virtual void SetDefaultCloudKeyboardTitle (const CYIString &title)=0
 Set the title string that will be shown when the keyboard is displayed. The default title will be superceded by an element with a title hint. More...
 
virtual const CYIStringGetDefaultCloudKeyboardTitle () const =0
 Get currently set default title for the cloud device. More...
 
virtual uint64_t RegisterDataListener (CYIString eventId, std::function< bool(CYIString eventId, const yi::rapidjson::Document *pEvent)> dataFunction)=0
 Register a data listener so that it may receive client data. More...
 
virtual void UnregisterDataListener (CYIString eventId, uint64_t listenerId)=0
 Unregister a data listener so that it no longer receives client data. More...
 
virtual void RegisterPersistentStore (const CYIString &name, CYIPersistentStore *pStore)=0
 Register the given persistent store object for synchronization with the client. More...
 
virtual void UnregisterPersistentStore (CYIPersistentStore *pStore)=0
 Unregister the given persistent object so that it is no longer synchronized with the client. More...
 
virtual void SendRokuAnalyticsEvent (const CYIString &eventName, const CYIString &parameters)=0
 Send the given event and paramaters to the Roku analytics framework. More...
 
virtual void GetIAPCustomerUID (std::function< void(const CloudIAPRequestStatus &status, const CloudIAPCustomerUID &customerUID)> responder)=0
 Request the client in-app purchase customer unique ID. This is an asynchronous network operation. The given responder will be invoked when complete. More...
 
virtual void GetIAPUser (std::function< void(const CloudIAPRequestStatus &status, const CloudIAPUser &iapUser)> responder)=0
 Request the client in-app purchase user account. This is an asynchronous network operation. The given responder will be invoked when complete. More...
 
virtual void GetAvailableProducts (std::function< void(const CloudIAPRequestStatus &status, const std::vector< std::shared_ptr< CloudIAPProduct >> &products)> responder)=0
 In app purchases request of available products for the channel This is an asynchronous network operation. The given responder will be invoked when complete. More...
 
virtual void GetUserPurchases (std::function< void(const CloudIAPRequestStatus &status, const std::vector< std::shared_ptr< CloudIAPPurchase >> &purchases)> responder)=0
 In app purchases request of user purchases This is an asynchronous network operation. The given responder will be invoked when complete. More...
 
virtual void RequestPurchase (const CYIString &productId, std::function< void(const CloudIAPRequestStatus, const CloudIAPReceipt &receipt)> responder)=0
 In app purchases request to purchase a given product This is an asynchronous network operation. The given responder will be invoked when complete. More...
 
virtual bool ConfigureVideoDrawer (CYIAbstractVideoPlayer *pVideoPlayer, CYISceneNode *pContentDrawerSceneNode, const CYIClientPlayer::ContentDrawerAnimations &animations)=0
 Associate video drawer with player. More...
 
virtual bool SetVideoPlayerColor (CYIAbstractVideoPlayer *pVideoPlayer, const CYIColor &color)=0
 Set the color of the video player controls. Note: Must be called after a video surface view has been associated with the player. More...
 
virtual void SendStopVideo ()=0
 Sends a 'stop' command to the active video node. More...
 
virtual void SendStopAnimation (const CYIString &animation, const CYISceneNode *pNode=nullptr)=0
 Sends a message to the client to stop the given animation. More...
 
virtual void SendEpgContent (CYISceneNode *pNode, const CloudEpgContentModel &content)=0
 Sends updated EPG content data. Notes: The given node must be specified as an EPG Grid with USE_EPG_GRID hint. More...
 
virtual void SendFocusEpgProgram (CYISceneNode *pNode, const CYIString &channelTitle, const int64_t startTime)=0
 Sends request focus to the specified program with given channel title and start time. More...
 
virtual void ReplaceSubtree (const CYISceneNode *pSubtreeRootNode, bool useJSON=false)=0
 Replace the given subtree on the client. A common use of this method is to update the content data of a list. Example: ReplaceSubtree(pListView, true) More...
 
virtual void SendErrorMessage (const CYIString &message)=0
 Send the given string to be displayed as a Roku error message. More...
 
virtual void PauseExportUpdates ()=0
 Pauses the automatic export process. Until resumed, changes to the scene tree will not result in automated exports. More...
 
virtual void ResumeExportUpdates ()=0
 Resumes the automatic export process. Changes to the scene tree will again result in automated exports. More...
 
virtual bool AreExportUpdatesPaused ()=0
 Returns true if the automatic export process is paused. More...
 
virtual void ExportPackagedLibrary (const CYIString &filename)=0
 DEBUG Purpose only. Export packaged zip file. More...
 
virtual void EnqueuePostExportAction (std::function< void()> action)=0
 Enqueue an action that will execute after the next scene export. More...
 
virtual void SetNavigationPersistenceKey (const CYIString &persistenceKey)=0
 Sets the persistence key for the navigate state. App will save the navigation history only if this gets called at the time of App::UserStart(). More...
 
virtual const CYIStringGetStatus () const =0
 Gets the stringified cloud app status from client. More...
 
virtual void SaveInstanceState (const CYIString &stringifiedState)=0
 Provide the stringified state of the application to be used when restarting the app instance. More...
 
virtual const CYIStringGetSavedInstanceState () const =0
 Retrieve the stringified saved state. More...
 
virtual std::shared_ptr< CYIPersistentStoreFindUnusedPersistentStore (const CYIString &name)=0
 Retrieve a persistent store containing data that was not stored when the app is started. More...
 

Public Attributes

CYISignal ExportComplete
 
CYISignal ClientBackgrounded
 Fired when the client starts playback or inactivated. More...
 

Protected Member Functions

virtual void AddUnusedPersistentStoreData (const CYIString &name, yi::rapidjson::Value *pData)=0
 Adds data to the list of unused persistent store data. More...
 

Protected Attributes

InterfaceType m_type = InterfaceType::NULL_INTERFACE
 

Friends

class CYICloudInterfaceManager
 
class CYICloudContext
 

Member Enumeration Documentation

Enumerator
NULL_INTERFACE 
ROKU_INTERFACE 
WEB_INTERFACE 
Enumerator
CLOSEST 

The closest item will receive focus.

PREVIOUS_ITEM 

The item that previously had focus should receive focus.

Enumerator
CLOSEST 

The item closest the source list item will receive focus.

CLOSEST_TO_LIST 

The item closest to the entire list will receive focus.

Constructor & Destructor Documentation

CYICloudInterface::CYICloudInterface ( )
default
virtual CYICloudInterface::~CYICloudInterface ( )
inlinevirtual

Member Function Documentation

virtual void CYICloudInterface::AddModalScene ( const CYIString name,
const CYISceneNode pSceneNode,
int32_t  layerIndex = 0,
std::set< CYIString associatedScenes = std::set< CYIString >() 
)
pure virtual

Identify overlay scene to be exported with initial components.

Parameters
nameis the name of the modal scene.
pSceneNodeis the node of the modal scene.
layerIndexis the index of the scene layer.
associatedScenesis the set of scenes this modal should be included with when exporting the component library. If empty, the modal will be included in all scenes.

Implemented in CYINullInterface.

virtual void CYICloudInterface::AddUnusedPersistentStoreData ( const CYIString name,
yi::rapidjson::Value *  pData 
)
protectedpure virtual

Adds data to the list of unused persistent store data.

This function is needed to support the recreation of the Async Storage module when a React Native app is live reloaded.

Implemented in CYINullInterface.

virtual bool CYICloudInterface::AreExportUpdatesPaused ( )
pure virtual

Returns true if the automatic export process is paused.

See also
PauseExportUpdates
EnableExportUpdates

Implemented in CYINullInterface.

virtual bool CYICloudInterface::Begin ( )
pure virtual

Begin listening for client connection.

Implemented in CYINullInterface.

virtual void CYICloudInterface::ClearClientFocus ( )
pure virtual

Clear the client's focus. The server will then push its own focus state once a view has focus.

Implemented in CYINullInterface.

virtual bool CYICloudInterface::ConfigureVideoDrawer ( CYIAbstractVideoPlayer pVideoPlayer,
CYISceneNode pContentDrawerSceneNode,
const CYIClientPlayer::ContentDrawerAnimations animations 
)
pure virtual

Associate video drawer with player.

Parameters
pVideoPlayeris the video player associated with the content drawer
pContentDrawerSceneNodecontains the CYIListView with the fully streamed in set of video content
animationsidentifies the names of the animations contained in the VideoListSceneNode to show and hide the drawer

Implemented in CYINullInterface.

virtual void CYICloudInterface::EnableLayoutExport ( bool  enable)
pure virtual

Enable export of layout properties into Roku's layout system instead of exporting the results of the You.i Engine layout system. Roku layouts support less features, but their advantage is that they will respond to content changes after export.

Implemented in CYINullInterface.

virtual void CYICloudInterface::EnqueuePostExportAction ( std::function< void()>  action)
pure virtual

Enqueue an action that will execute after the next scene export.

Implemented in CYINullInterface.

virtual void CYICloudInterface::ExportPackagedLibrary ( const CYIString filename)
pure virtual

DEBUG Purpose only. Export packaged zip file.

See also
ExportStagedScenes

Implemented in CYINullInterface.

virtual void CYICloudInterface::ExportStagedScenes ( )
pure virtual

Export all staged scenes. This is executed immediately.

See also
AddModalScene

Implemented in CYINullInterface.

virtual std::shared_ptr<CYIPersistentStore> CYICloudInterface::FindUnusedPersistentStore ( const CYIString name)
pure virtual

Retrieve a persistent store containing data that was not stored when the app is started.

In react native apps, the Async Storage module is lazy instantiated, so data not laoded into an existing store at load time is retained for when it is created. If no persistent store is found with the given name, nullptr is returned.

Implemented in CYINullInterface.

virtual void CYICloudInterface::GetAvailableProducts ( )
pure virtual

In app purchases request of available products for the channel This is an asynchronous network operation. The given responder will be invoked when complete.

Implemented in CYINullInterface.

virtual const CYIString& CYICloudInterface::GetClientExternalIp ( ) const
pure virtual

Return the external IP of the client.

Implemented in CYINullInterface.

virtual const CYIString& CYICloudInterface::GetDefaultCloudKeyboardTitle ( ) const
pure virtual

Get currently set default title for the cloud device.

See also
SetDefaultCloudKeyboardTitle

Implemented in CYINullInterface.

virtual void CYICloudInterface::GetIAPCustomerUID ( std::function< void(const CloudIAPRequestStatus &status, const CloudIAPCustomerUID &customerUID)>  responder)
pure virtual

Request the client in-app purchase customer unique ID. This is an asynchronous network operation. The given responder will be invoked when complete.

virtual void CYICloudInterface::GetIAPUser ( std::function< void(const CloudIAPRequestStatus &status, const CloudIAPUser &iapUser)>  responder)
pure virtual

Request the client in-app purchase user account. This is an asynchronous network operation. The given responder will be invoked when complete.

virtual const CYIClientPlayer::PlaybackSessionInfo& CYICloudInterface::GetLastPlaybackSessionInfo ( ) const
pure virtual

Get the recently updated playback session information such as bookmark and audio/cc settings.

See also
CYIClientPlayer::PlaybackSessionInfo

Implemented in CYINullInterface.

virtual const CYIString& CYICloudInterface::GetSavedInstanceState ( ) const
pure virtual

Retrieve the stringified saved state.

Implemented in CYINullInterface.

virtual const CYIString& CYICloudInterface::GetStatus ( ) const
pure virtual

Gets the stringified cloud app status from client.

When a new server instance gets created by reconnection request from a client, a set of context information will be provided. The context information will contain the statusCode, errorCode and errorMessage. The errorCode and errorMessage will be provided only when reconnecting with error situation. This is read only.

Implemented in CYINullInterface.

virtual void CYICloudInterface::GetUserPurchases ( )
pure virtual

In app purchases request of user purchases This is an asynchronous network operation. The given responder will be invoked when complete.

Implemented in CYINullInterface.

virtual void CYICloudInterface::HideWaitSpinner ( )
pure virtual

Hide the wait spinner.

Implemented in CYINullInterface.

virtual bool CYICloudInterface::Init ( CYIApp pApp)
pure virtual

Initialize the cloud sdk.

Parameters
pAppis the pointer to the application.

Implemented in CYINullInterface.

virtual void CYICloudInterface::InvokeCommand ( const CYIString  cmd,
const CYIBundle args = CYIBundle(),
std::function< void(bool, CYIBundle)>  callback = nullptr 
)
pure virtual

Invoke custom client command.

Parameters
cmdis the name of the custom command.
argsa map of argument name and value pairs. Value is CYIAny but limited to simple types such as int, bool and string.
callbackis called with the result of the custom command.

Implemented in CYINullInterface.

virtual bool CYICloudInterface::IsCloudServer ( )
pure virtual

Returns true if the implementation is a cloud server.

Implemented in CYINullInterface.

virtual bool CYICloudInterface::IsLowEndDevice ( )
pure virtual

Returns true if the device is low end.

Implemented in CYINullInterface.

virtual bool CYICloudInterface::IsUsingNullRenderer ( ) const
pure virtual

Return true if the cloud sdk is using the null renderer.

Implemented in CYINullInterface.

virtual void CYICloudInterface::PauseExportUpdates ( )
pure virtual

Pauses the automatic export process. Until resumed, changes to the scene tree will not result in automated exports.

See also
ResumeExportUpdates
EnableExportUpdates
AreExportUpdatesPaused
Export

Implemented in CYINullInterface.

virtual uint64_t CYICloudInterface::RegisterDataListener ( CYIString  eventId,
std::function< bool(CYIString eventId, const yi::rapidjson::Document *pEvent)>  dataFunction 
)
pure virtual

Register a data listener so that it may receive client data.

Implemented in CYINullInterface.

virtual void CYICloudInterface::RegisterPersistentStore ( const CYIString name,
CYIPersistentStore pStore 
)
pure virtual

Register the given persistent store object for synchronization with the client.

Each CYIPersistentObject is mapped to a unique Roku object specified by the 'name' parameter. Earlier versions of the Roku Client synchronized all CYIPersistentStore objects with a single, hardcoded Roku object, called "PersistentStore." When upgrading from an older Cloud version to a current version, you'll need to RegisterPersistentStore() using "PersistentStore" as the name in order to retrieve persistent data saved under the old version. This function must be called in your app's UserInit function.

Implemented in CYINullInterface.

virtual void CYICloudInterface::RemoveModalScene ( const CYIString name)
pure virtual

Remove an overlay scene from the set of registered modals.

Implemented in CYINullInterface.

virtual void CYICloudInterface::ReplaceSubtree ( const CYISceneNode pSubtreeRootNode,
bool  useJSON = false 
)
pure virtual

Replace the given subtree on the client. A common use of this method is to update the content data of a list. Example: ReplaceSubtree(pListView, true)

Parameters
pSubtreeRootNodeis the root of the subtree to update.
useJSONindicates the update will be sent as JSON. JSON transfer is faster, but a list item template cannot be updated using this format.
See also
InsertSubtree
DeleteClientSubtree

Implemented in CYINullInterface.

virtual void CYICloudInterface::RequestPurchase ( const CYIString productId,
std::function< void(const CloudIAPRequestStatus, const CloudIAPReceipt &receipt)>  responder 
)
pure virtual

In app purchases request to purchase a given product This is an asynchronous network operation. The given responder will be invoked when complete.

virtual void CYICloudInterface::ResumeExportUpdates ( )
pure virtual

Resumes the automatic export process. Changes to the scene tree will again result in automated exports.

See also
PauseExportUpdates
EnableExportUpdates
AreExportUpdatesPaused
Export

Implemented in CYINullInterface.

virtual bool CYICloudInterface::RunMainLoop ( )
pure virtual

Run the CYIApp main loop.

Implemented in CYINullInterface.

virtual void CYICloudInterface::SaveInstanceState ( const CYIString stringifiedState)
pure virtual

Provide the stringified state of the application to be used when restarting the app instance.

SaveInstanceState should be called as a response to the background event from ClientBackgrounded signal. The application is terminated once its instance state is saved.

Parameters
stringifiedStatecontains the string that will be provided to new incarnation of the application to rebuild the current screen and stacked screen state of the application.
See also
ClientBackgrounded

Implemented in CYINullInterface.

virtual void CYICloudInterface::ScrollListToIndex ( CYISceneNode pListNode,
uint32_t  index 
)
pure virtual

Scroll the list item in the specified list at the specified index into view.

Implemented in CYINullInterface.

virtual void CYICloudInterface::SendEpgContent ( CYISceneNode pNode,
const CloudEpgContentModel content 
)
pure virtual

Sends updated EPG content data. Notes: The given node must be specified as an EPG Grid with USE_EPG_GRID hint.

Implemented in CYINullInterface.

virtual void CYICloudInterface::SendErrorMessage ( const CYIString message)
pure virtual

Send the given string to be displayed as a Roku error message.

Implemented in CYINullInterface.

virtual void CYICloudInterface::SendFocusEpgProgram ( CYISceneNode pNode,
const CYIString channelTitle,
const int64_t  startTime 
)
pure virtual

Sends request focus to the specified program with given channel title and start time.

Implemented in CYINullInterface.

virtual bool CYICloudInterface::SendFocusMap ( CYISceneManager pSceneManager = nullptr)
pure virtual

Send a generated focus map to the client.

Implemented in CYINullInterface.

virtual void CYICloudInterface::SendRokuAnalyticsEvent ( const CYIString eventName,
const CYIString parameters 
)
pure virtual

Send the given event and paramaters to the Roku analytics framework.

Implemented in CYINullInterface.

virtual void CYICloudInterface::SendScrollingTextViewUpdate ( const CYISceneNode pScrollingTextView,
const CYIString text,
const CYIString title 
)
pure virtual

Update the text for a scrolling text view.

Implemented in CYINullInterface.

virtual void CYICloudInterface::SendScrollToNode ( const CYISceneView pScrollingView,
const CYISceneNode pNode 
)
pure virtual

Scroll the given scrolling view to the provided node.

Implemented in CYINullInterface.

virtual void CYICloudInterface::SendStopAnimation ( const CYIString animation,
const CYISceneNode pNode = nullptr 
)
pure virtual

Sends a message to the client to stop the given animation.

Implemented in CYINullInterface.

virtual void CYICloudInterface::SendStopVideo ( )
pure virtual

Sends a 'stop' command to the active video node.

Implemented in CYINullInterface.

virtual void CYICloudInterface::SendUpdatedListItemField ( CYISceneView pList,
const std::map< CYISceneNode *, CYIString > &  updateMap,
const int32_t  itemIndex 
)
pure virtual

Update fields on a given list item. The updateMap contains the list item view to update and the new value (i.e. text field, uri). .

Deprecated:
This function is only valid when using the old Roku list. On the new default ComponenetScrollView this function will be a NoOp. This call should be considered deprecated as support for the old Roku list is being phased out. \
Parameters
pListis the list (CYIListView or yi::deprecated::CYIListView) to modify
updateMapcontains the mapping of CYISceneNodes to their new values. For text updates, provide the CYITextSceneNode from the list item view and the new text. For image updates, provide the CYIImageNode and the new image uri. Otherwise provide the scene node and the updated visibility status.
itemIndexrefers the to list item index to update

Implemented in CYINullInterface.

virtual void CYICloudInterface::SetDefaultCloudKeyboardTitle ( const CYIString title)
pure virtual

Set the title string that will be shown when the keyboard is displayed. The default title will be superceded by an element with a title hint.

See also
SetDefaultCloudKeyboardTitle

Implemented in CYINullInterface.

virtual bool CYICloudInterface::SetExportHint ( CYISceneNode pNode,
const CYIString hintName,
const CYIAny value 
)
pure virtual

Apply the given export hint to a scene node.

Implemented in CYINullInterface.

virtual void CYICloudInterface::SetFocusOnSceneNode ( const CYISceneNode pNode)
pure virtual

Set client focus on the specified scene node.

Implemented in CYINullInterface.

virtual void CYICloudInterface::SetIncomingFocusStyle ( CYIListView pList,
ListIncomingFocusStyle  focusStyle 
)
pure virtual

Used to set up how focus will be calculated when list recieves focus from another item.

Parameters
pListis the list that is being configured.
focusStyleis the style of focus.

Implemented in CYINullInterface.

virtual void CYICloudInterface::SetInitalScrollIndexWithFocus ( CYIListView pList,
uint32_t  index 
)
pure virtual

Call setInitalScrollIndexWithFocus to set the initial scroll index of the list. This method will also set focus to the corresponding list item. It this API called in a react native application, it should be called via onLoad. Please do not call this method from other RN life cycle methods as this can cause incorrect application behaviour (The focus request is delayed until after the client receives the new scene graph update).

Parameters
pListis the list will receive focus.
indexcoresponds to the list item that will receive focus.

Implemented in CYINullInterface.

virtual void CYICloudInterface::SetNavigationPersistenceKey ( const CYIString persistenceKey)
pure virtual

Sets the persistence key for the navigate state. App will save the navigation history only if this gets called at the time of App::UserStart().

Parameters
persistenceKeyis the key for the persistence store.

Implemented in CYINullInterface.

virtual void CYICloudInterface::SetOutgoingFocusStyle ( CYIListView pList,
ListOutgoingFocusStyle  focusStyle 
)
pure virtual

Used to set up how focus will be calculated when list recieves focus from another item.

Parameters
pListis the list that is being configured.
focusStyleis the style of focus.

Implemented in CYINullInterface.

virtual void CYICloudInterface::SetSpinnerDelayMs ( uint32_t  delayMs)
pure virtual

Sets the time of spinner delay in milliseconds.

Parameters
delayMsis the duration of delaying before showing in milliseconds. If hiding the spinner gets called within the duration, spinner won't show. Default value is 2000ms for Roku requirement of 3 secs with a second of margin.

Implemented in CYINullInterface.

virtual void CYICloudInterface::SetUseNullRenderer ( bool  useNull)
pure virtual

Enable or disable the use of the null renderer.

Implemented in CYINullInterface.

virtual bool CYICloudInterface::SetVideoMetadata ( CYIAbstractVideoPlayer pVideoPlayer,
const CYIAbstractVideoPlayer::VideoMetadata metadata 
)
pure virtual

Add video data such as videoUrl, title, contentId (required for player analytics)

Implemented in CYINullInterface.

virtual bool CYICloudInterface::SetVideoPlayerColor ( CYIAbstractVideoPlayer pVideoPlayer,
const CYIColor color 
)
pure virtual

Set the color of the video player controls. Note: Must be called after a video surface view has been associated with the player.

Implemented in CYINullInterface.

virtual void CYICloudInterface::ShowWaitSpinner ( )
pure virtual

Show the wait spinner with configured delay.

See also
SetSpinnerDelayMs

Implemented in CYINullInterface.

virtual void CYICloudInterface::ShowWaitSpinnerNow ( )
pure virtual

Show the wait spinner right away.

Note
This call will force to show the spinner right away without respecting the configured delay duration.

Implemented in CYINullInterface.

virtual void CYICloudInterface::Shutdown ( )
pure virtual

Shutdown the cloud sdk.

Implemented in CYINullInterface.

virtual void CYICloudInterface::TerminateApplication ( )
pure virtual

Terminate the Application and return to the home screen.

Implemented in CYINullInterface.

virtual void CYICloudInterface::UnregisterDataListener ( CYIString  eventId,
uint64_t  listenerId 
)
pure virtual

Unregister a data listener so that it no longer receives client data.

Implemented in CYINullInterface.

virtual void CYICloudInterface::UnregisterPersistentStore ( CYIPersistentStore pStore)
pure virtual

Unregister the given persistent object so that it is no longer synchronized with the client.

Implemented in CYINullInterface.

Friends And Related Function Documentation

friend class CYICloudContext
friend
friend class CYICloudInterfaceManager
friend

Member Data Documentation

CYISignal CYICloudInterface::ClientBackgrounded

Fired when the client starts playback or inactivated.

See also
SaveInstanceState
CYISignal CYICloudInterface::ExportComplete
InterfaceType CYICloudInterface::m_type = InterfaceType::NULL_INTERFACE
protected

The documentation for this class was generated from the following file: