Difference between revisions of "Broadcast System"
Jump to navigation
Jump to search
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...
m (grammar fixes) |
|||
Line 1: | Line 1: | ||
− | <center>'''RocketLauncher | + | <center>'''RocketLauncher supports third party communication through a built-in message broadcast system.</center><br /> |
− | <center>'''You can for example build | + | <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 | + | <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 | + | *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. | |
− | + | #On the left pane, choose global. | |
− | + | #Select the General Settings tab. | |
− | + | #On the RocketLauncher sub tab, go to the Broadcast section. | |
− | + | #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 | + | *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 | + | *<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 | + | *<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 | + | *<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> ( | + | *<span style="color: orange;">'''command|RLPause'''</span> (simulates a Pause key press) |
− | *<span style="color: orange;">'''command|RLSelect'''</span> (simulate | + | *<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 | + | *<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 | + | *<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 | + | *<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 | + | *<span style="color: orange;">'''command|RLDown'''</span> (simulate selecting Down key press) (currently only available on Pause) |
− | *<span style="color: orange;">'''command|RLExit'''</span> ( | + | *<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 | + | *<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 | + | *<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 | + | *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
Contents
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.
- Open RocketLauncherUI.
- On the left pane, choose global.
- Select the General Settings tab.
- On the RocketLauncher sub tab, go to the Broadcast section.
- 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.