2. Game operations

Detailed Description

Game operations

These are mandatory functions for using this addon to get the available channels.

---

Game operation parts in interface:
Copy this to your project and extend with your parts or leave functions complete away where not used or supported.

Topics
	Class: CStream
	Class: kodi::addon::CInstanceGame::CStream Game stream handler

Function Documentation

LoadGame()

virtual GAME_ERROR LoadGame ( const std::string & url )

inlinevirtual

Load a game.

Parameters

[in]

url

The URL to load

Returns

the error, or GAME_ERROR_NO_ERROR if the game was loaded

LoadGameSpecial()

virtual GAME_ERROR LoadGameSpecial ( SPECIAL_GAME_TYPE type, const std::vector< std::string > & urls )

inlinevirtual

Load a game that requires multiple files.

Parameters

[in]	type	The game type
[in]	urls	An array of urls

Returns

the error, or GAME_ERROR_NO_ERROR if the game was loaded

LoadStandalone()

virtual GAME_ERROR LoadStandalone ( )

inlinevirtual

Begin playing without a game file.

If the add-on supports standalone mode, it must add the <supports_standalone> tag to the extension point in addon.xml:

<supports_no_game>false</supports_no_game>

Returns

the error, or GAME_ERROR_NO_ERROR if the game add-on was loaded

UnloadGame()

virtual GAME_ERROR UnloadGame ( )

inlinevirtual

Unload the current game.

Unloads a currently loaded game

Returns

the error, or GAME_ERROR_NO_ERROR if the game was unloaded

GetGameTiming()

virtual GAME_ERROR GetGameTiming ( game_system_timing & timing_info )

inlinevirtual

Get timing information about the loaded game.

Parameters

[out]

timing_info

The info structure to fill

Returns

the error, or GAME_ERROR_NO_ERROR if info was filled

GetRegion()

virtual GAME_REGION GetRegion ( )

inlinevirtual

Get region of the loaded game.

Returns

the region, or GAME_REGION_UNKNOWN if unknown or no game is loaded

RequiresGameLoop()

virtual bool RequiresGameLoop ( )

inlinevirtual

Return true if the client requires the frontend to provide a game loop.

The game loop is a thread that calls RunFrame() in a loop at a rate determined by the playback speed and the client's FPS.

Returns

true if the frontend should provide a game loop, false otherwise

RunFrame()

virtual GAME_ERROR RunFrame ( )

inlinevirtual

Run a single frame for add-ons that use a game loop.

Returns

the error, or GAME_ERROR_NO_ERROR if there was no error

Reset()

virtual GAME_ERROR Reset ( )

inlinevirtual

Reset the current game.

Returns

the error, or GAME_ERROR_NO_ERROR if the game was reset

CloseGame()

void CloseGame ( void )

inline

Callback to Kodi Function
Requests the frontend to stop the current game

Remarks

Only called from addon itself