Difference between revisions of "Broadcast System"

From RocketLauncher Wiki
Jump to navigation Jump to search
m (grammar fixes)
 
Line 1: Line 1:
<center>'''RocketLauncher support third party communication through a built in message broadcast system.</center><br />
+
<center>'''RocketLauncher supports third party communication through a built-in message broadcast system.</center><br />
<center>'''You can for example build an third party app to pause a game or control any RocketLauncher command from a smartphone.</center><br />
+
<center>'''You can, for example, build a third-party app to pause a game or control any RocketLauncher command from a smartphone.</center><br />
<center>'''You also can receive RocketLauncher messages that describes its state, if it started, paused, exit,...</center><br />
+
<center>'''You can also receive RocketLauncher messages that describe its state, if it started, paused, exit, etc...</center><br />
  
 
----
 
----
Line 8: Line 8:
  
 
==Setting your program to receive RocketLauncher messages==
 
==Setting your program to receive RocketLauncher messages==
*You just need to set on RocketLauncher the window name of your program so RocketLauncher is able to send its messages to your app.
+
*You just need to set in RocketLauncherUI, the window name of your program so RocketLauncher is able to send its messages to your application.
*Open RocketLauncherUI
+
#Open RocketLauncherUI.
*On the left pane choose global
+
#On the left pane, choose global.
*Select the General Settings tab
+
#Select the General Settings tab.
*On the RocketLauncher sub tab, go to the Broadcast section
+
#On the RocketLauncher sub tab, go to the Broadcast section.
*Fill the broadcast window title field with the window title name of your program.
+
#Fill the broadcast window title field with the window title name of your program.
  
 
==Sending messages to RocketLauncher from your external program==
 
==Sending messages to RocketLauncher from your external program==
*You just need to send one of the bellow listed valid messages to the window named: '''RocketLauncherMessageReceiver'''   
+
*You just need to send one of the below listed valid messages to the window named: '''RocketLauncherMessageReceiver'''   
  
 
=Valid Messages=
 
=Valid Messages=
Line 25: Line 25:
 
*<span style="color: orange;">'''RocketLauncher Message: Game Paused.'''</span> (sent when you pause a game)
 
*<span style="color: orange;">'''RocketLauncher Message: Game Paused.'''</span> (sent when you pause a game)
 
*<span style="color: orange;">'''RocketLauncher Message: Resuming Game.'''</span> (sent when you resume a game)
 
*<span style="color: orange;">'''RocketLauncher Message: Resuming Game.'''</span> (sent when you resume a game)
*<span style="color: orange;">'''RocketLauncher Message System is Available.'''</span> (sent as a answer to a ping request)
+
*<span style="color: orange;">'''RocketLauncher Message System is Available.'''</span> (sent as an answer to a ping request)
*<span style="color: orange;">'''RocketLauncher Message. Current System: SystemName'''</span> (sent as a answer to a Which system? request)
+
*<span style="color: orange;">'''RocketLauncher Message. Current System: SystemName'''</span> (sent as an answer to a Which system? request)
*<span style="color: orange;">'''RocketLauncher Message. Current Game: GameName'''</span> (sent as a answer to a Which game? request)
+
*<span style="color: orange;">'''RocketLauncher Message. Current Game: GameName'''</span> (sent as an answer to a Which game? request)
  
 
==Valid messages received by RocketLauncher==
 
==Valid messages received by RocketLauncher==
*<span style="color: orange;">'''command|RLPause'''</span> (simulate pause key press)
+
*<span style="color: orange;">'''command|RLPause'''</span> (simulates a Pause key press)
*<span style="color: orange;">'''command|RLSelect'''</span> (simulate select key press) (currently only available on pause)
+
*<span style="color: orange;">'''command|RLSelect'''</span> (simulate a Select key press) (currently only available on Pause)
*<span style="color: orange;">'''command|RLUp'''</span> (simulate select Up key press) (currently only available on pause)
+
*<span style="color: orange;">'''command|RLUp'''</span> (simulate selecting Up key press) (currently only available on Pause)
*<span style="color: orange;">'''command|RLLeft'''</span> (simulate select Left key press) (currently only available on pause)
+
*<span style="color: orange;">'''command|RLLeft'''</span> (simulate selecting Left key press) (currently only available on Pause)
*<span style="color: orange;">'''command|RLRight'''</span> (simulate select Right key press) (currently only available on pause)
+
*<span style="color: orange;">'''command|RLRight'''</span> (simulate selecting Right key press) (currently only available on Pause)
*<span style="color: orange;">'''command|RLDown'''</span> (simulate select Down key press) (currently only available on pause)
+
*<span style="color: orange;">'''command|RLDown'''</span> (simulate selecting Down key press) (currently only available on Pause)
*<span style="color: orange;">'''command|RLExit'''</span> (simulate select Exit RocketLauncher key press)  
+
*<span style="color: orange;">'''command|RLExit'''</span> (simulates selecting Exit RocketLauncher key press)  
 
*<span style="color: orange;">'''ping'''</span> (message to test the reachability of RocketLauncher. Once received, RocketLauncher will send back the message "RocketLauncher Message System is Available." to all windows configured to receive broadcasted messages on RocketLauncherUI)
 
*<span style="color: orange;">'''ping'''</span> (message to test the reachability of RocketLauncher. Once received, RocketLauncher will send back the message "RocketLauncher Message System is Available." to all windows configured to receive broadcasted messages on RocketLauncherUI)
*<span style="color: orange;">'''Which system?'''</span> (message to ask RocketLauncher to send which is the current system. Once received, RocketLauncher will send back the message "RocketLauncher Message. Current System: SystemName", where SystemName is the name of the current system, to all windows configured to receive broadcasted messages on RocketLauncherUI)
+
*<span style="color: orange;">'''Which system?'''</span> (message to ask RocketLauncher to send what the current system is. Once received, RocketLauncher will send back the message "RocketLauncher Message. Current System: SystemName", where SystemName is the name of the current system, to all windows configured to receive broadcasted messages on RocketLauncherUI)
*<span style="color: orange;">'''Which game?'''</span> (message to ask RocketLauncher to send which is the current game. Once received, RocketLauncher will send back the message "RocketLauncher Message. Current System: gameName", where GameName is the name of the current game, to all windows configured to receive broadcasted messages on RocketLauncherUI)
+
*<span style="color: orange;">'''Which game?'''</span> (message to ask RocketLauncher to send what the current game is. Once received, RocketLauncher will send back the message "RocketLauncher Message. Current System: gameName", where GameName is the name of the current game, to all windows configured to receive broadcasted messages on RocketLauncherUI)
  
 
=Code example=
 
=Code example=
*On the bellow link you can find a small AHK code able to handling the RocketLauncher communication and control commands to serve as example if you want to use this feature by your own.
+
*On the below link you can find a small AHK code able to handle the RocketLauncher communication and control commands to serve as an example if you want to use this feature on your own.
 
*You just need to set, as explained in the beginning of this page, the Broadcast Window title on RocketLauncherUI to: '''RocketLauncherController'''.
 
*You just need to set, as explained in the beginning of this page, the Broadcast Window title on RocketLauncherUI to: '''RocketLauncherController'''.
 
[http://ge.tt/4xHs0uJ2/v/0?c Broadcast App Code Example]
 
[http://ge.tt/4xHs0uJ2/v/0?c Broadcast App Code Example]

Latest revision as of 18:06, 7 July 2015

RocketLauncher supports third party communication through a built-in message broadcast system.


You can, for example, build a third-party app to pause a game or control any RocketLauncher command from a smartphone.


You can also receive RocketLauncher messages that describe its state, if it started, paused, exit, etc...



Instructions

Setting your program to receive RocketLauncher messages

  • You just need to set in RocketLauncherUI, the window name of your program so RocketLauncher is able to send its messages to your application.
  1. Open RocketLauncherUI.
  2. On the left pane, choose global.
  3. Select the General Settings tab.
  4. On the RocketLauncher sub tab, go to the Broadcast section.
  5. Fill the broadcast window title field with the window title name of your program.

Sending messages to RocketLauncher from your external program

  • You just need to send one of the below listed valid messages to the window named: RocketLauncherMessageReceiver

Valid Messages

Messages sent by RocketLauncher

  • RocketLauncher Message: Welcome! :) (sent when RocketLauncher starts)
  • RocketLauncher Message: Goodbye! :( (sent when you exit RocketLauncher)
  • RocketLauncher Message: Game Paused. (sent when you pause a game)
  • RocketLauncher Message: Resuming Game. (sent when you resume a game)
  • RocketLauncher Message System is Available. (sent as an answer to a ping request)
  • RocketLauncher Message. Current System: SystemName (sent as an answer to a Which system? request)
  • RocketLauncher Message. Current Game: GameName (sent as an answer to a Which game? request)

Valid messages received by RocketLauncher

  • command|RLPause (simulates a Pause key press)
  • command|RLSelect (simulate a Select key press) (currently only available on Pause)
  • command|RLUp (simulate selecting Up key press) (currently only available on Pause)
  • command|RLLeft (simulate selecting Left key press) (currently only available on Pause)
  • command|RLRight (simulate selecting Right key press) (currently only available on Pause)
  • command|RLDown (simulate selecting Down key press) (currently only available on Pause)
  • command|RLExit (simulates selecting Exit RocketLauncher key press)
  • ping (message to test the reachability of RocketLauncher. Once received, RocketLauncher will send back the message "RocketLauncher Message System is Available." to all windows configured to receive broadcasted messages on RocketLauncherUI)
  • Which system? (message to ask RocketLauncher to send what the current system is. Once received, RocketLauncher will send back the message "RocketLauncher Message. Current System: SystemName", where SystemName is the name of the current system, to all windows configured to receive broadcasted messages on RocketLauncherUI)
  • Which game? (message to ask RocketLauncher to send what the current game is. Once received, RocketLauncher will send back the message "RocketLauncher Message. Current System: gameName", where GameName is the name of the current game, to all windows configured to receive broadcasted messages on RocketLauncherUI)

Code example

  • On the below link you can find a small AHK code able to handle the RocketLauncher communication and control commands to serve as an example if you want to use this feature on your own.
  • You just need to set, as explained in the beginning of this page, the Broadcast Window title on RocketLauncherUI to: RocketLauncherController.

Broadcast App Code Example