Roku SDK Documentation : SceneGraph Developer Extensions Components

m.top.ComponentController.callFunc("show", {
view: screen
	})

// MainScene.xml
<?xml version="1.0" encoding="UTF-8"?>
<component name="MainScene" extends="BaseScene" >
<script type="text/brightscript" uri="pkg:/components/MainScene.brs" />
</component>

// MainScene.brs
sub Show(args)
homeGrid = CreateObject("roSGNode", "GridView")
	homeGrid.content = GetContentNodeForHome() 'implemented by user
	homeGrid.ObserveField("rowItemSelected","OnGridItemSelected")
'this will trigger job to show the view
m.top.ComponentController.callFunc("show", {
	view: homeGrid
	})
end sub

// SimpleContentHandler.xml

<?xml version="1.0" encoding="UTF-8"?>
<component name="SimpleContentHandler" extends="ContentHandler" >
<script type="text/brightscript" uri="pkg:/components/content/SimpleContentHandler.brs" />
</component>

// SimpleContentHandler.brs

sub GetContent()
m.top.content.SetFields({
	title: "Hello World"
		 })
end sub

// [In <component name="HandlerEntitlement" extends="EntitlementHandler"> in channel]
sub ConfigureEntitlements(config as Object)
config.products = [
'{code: "PROD1", hasTrial: false}
{code: "PROD2", hasTrial: false}
	]
end sub

sub ConfigureRAF(adIface)
// Detailed RAF docs: https://sdkdocs.roku.com/display/sdkdoc/Integrating+the+Roku+Advertising+Framework 
adIface.SetAdUrl("http://www.some.ad.url.com")
adIface.SetContentGenre("General Variety")
adIface.SetContentLength(1200) ' in seconds
// Nielsen specific data
adIface.EnableNielsenDAR(true)
adIface.SetNielsenProgramId("CBAA")
adIface.SetNielsenGenre("GV")
adIface.SetNielsenAppId("P123QWE-1A2B-1234-5678-C7D654348321")
end sub

CategoryList = CreateObject("roSGNode", "CategoryListView")
	CategoryList.posterShape = "square"

content = CreateObject("roSGNode", "ContentNode")
	content.Addfields({
HandlerCategoryList: {
	name: "CGSeasons"
     }
})

CategoryList.content = content
	CategoryList.ObserveField("selectedItem", "OnEpisodeSelected")

'Triggers a job to show the view
m.top.ComponentController.CallFunc("show", {
	view: CategoryList
})

// Advanced loading logic

root = {
HandlerConfigCategoryList: {
_description: "Content handler that will be called to populate categories if they are not created"
	name: "Component name that extends [ContentHandler](#ContentHandler)"
	fields: {
		field: "any field that you want to set in this component when it's created"
       }
   }

_comment: "categories"
children: [{
	title: "Category that is prepopulated"
	contentType: "section"
children: [{
	title: "Title to be shown"
	description: "Description for item, max 4 lines"
	hdPosterUrl: "image url for item"
   }]
 
_optionalFields: "Fields that can be used for category"

HDLISTITEMICONURL: "icon that will be shown left to category when not focused"
HDLISTITEMICONSELECTEDURL: "icon that will be shown left to category title when focused"
HDGRIDPOSTERURL: "icon that will be shown left to title in item list"
  }, 
 
{
title: "Category that requires content to be loaded"
	contentType: "section"

HandlerConfigCategoryList: {
_description: "Content handler that will be called if there are no children in category"
	name: "Component name that extends [ContentHandler](#ContentHandler)"
	fields: {
		field: "any field that you want to set in this component when it's created"
        }
     }
 }, 
 
{
title: "Category that has children but they need metadata (non serial model)"
	contentType: "section"

HandlerConfigCategoryList: {
_description: "Content handler that will be called if "
	name: "Component name that extends [ContentHandler](#ContentHandler)"
_note: "use bigger value for page size to improve performance"
_mandatatory: "This field is required in order to work"

pageSize: 2
	fields: {
		field: "any field that you want to set in this component when it's created"
        }
    }
children: [{title: "Title to be shown"}
{title: "Title to be shown"}
{title: "Title to be shown"}
{title: "Title to be shown"}]
  }, 
 
{
title: "Category has children but there are more items that can be loaded"
	contentType: "section"

HandlerConfigCategoryList: {
_description: "Content handler will be called when focused near end of category"
	name: "Component name that extends [ContentHandler](#ContentHandler)"
_mandatatory: "This field is required in order to work"
	hasMore: true
	fields: {
		field: "any field that you want to set in this component when it's created"
        }
   }

children: [{
	title: "Title to be shown"
	description: "Description for item, max 4 lines"
	hdPosterUrl: "image url for item"
          }]
    }]
}

CategoryList = CreateObject("roSGNode", "CategoryListView")
	CategoryList.posterShape = "square"

content = CreateObject("roSGNode", "ContentNode")
	content.update(root)

CategoryList.content = content

'Triggers a job to show the view
m.top.ComponentController.CallFunc("show", {
	view: CategoryList
 })

video = CreateObject("roSGNode", "VideoView")

	video.content = content
	video.jumpToItem = index
	video.control = "play"

m.top.ComponentController.callFunc("show", {
	view: video
	})

'User can observe video.endcardItemSelected to handle endcard selection
'video.currentIndex or video.currentItem fields can be used to track what was the last video after a video is closed.

grid = CreateObject("roSGNode", "GridView")
	grid.setFields({
	style: "standard"
	posterShape: "16x9"
})
content = CreateObject("roSGNode", "ContentNode")
	content.addfields({
	HandlerConfigGrid: {
	name: "CHRoot"
	}
})
grid.content = content

'Triggers a job to show the view
m.top.ComponentController.callFunc("show", {
	view: grid
	})

// [In channel]
// contentItem - content node with handlerConfigEntitlement: {name : "HandlerEntitlement"}

// To make just silent check if user subscribed
ent = CreateObject("roSGNode", "EntitlementView")
	ent.ObserveField("isSubscribed", "OnSubscriptionChecked")
	ent.content = contentItem
	ent.silentCheckEntitlement = true

// To show billing flow
ent = CreateObject("roSGNode","EntitlementView")
	ent.ObserveField("isSubscribed", "OnIsSubscribedToPlay")
	ent.content = contentItem
m.top.ComponentController.callFunc("show", {view: ent})