The RockTvApp is a wrapper for the Apple App class. It provides several helper and wrapper functions to make life easier. Specifically this class is needed to allow for the Shell to have basic logic to handle network issues and parse errors gracefully.

Application Images

The native App class will call the same events on the RockTvApp object. There's no reason why you could not attach to the native App class events, but in general you should keep your logic in the RockTvApp. Below are a summary of the events that are supported.

• onLaunch
• onError
• onExit
• onResume
• onSuspend

Methods

The RockTvApp supports the following methods.

• reload - Calling this will call the App reload function.

AppState

The RockTvApp has an AppState property that provides state information about the application. These values come from the shell logic. This is a bridge between the shell and the application. These are intentionally named the same as Rock Mobile when possible.

Helper Functions

Below are a set of the helper functions available to you.

createAlertDocument(title, description)

The function will return a TVML document with the title and description inserted. The alert is rather plain, but you can override it in your application. The primary reason it's defined in the Shell is to allow for handling errors when things don't go well loading the application's JavaScript.

var alert = RockTvApp.createAlertDocument("Made It", "Looks like we made it.");