DVPRemote For Roku - URL Schemes
DVPRemote For Roku - URL Schemes
Background
DVPRemote startup using a custom URL scheme was introduced in version 2.1 of DVPRemote. It is intended to be used by other applications (e.g. home theater controls) to exercise control of Roku players through DVPRemote.
Supported URL Schemes
The following URL schemes:
Start DVPRemote:
dvpremote://
Start DVPRemote and send specified key press to the currently selected player:
dvpremote://?key=Key To Press
Start DVPRemote and select a specified channel on the currently selected player:
dvpremote://?channel=Channel to Select
Start DVPRemote and send specified key press to the specified player:
dvpremote://Player Name?key=Key To Press
Start DVPRemote and change to the specified channel on the specified player:
dvpremote://Player Name?channel=Channel to Select
Start DVPRemote and paste the text to the currently selected player from the cut/paste buffer of the iOS device:
dvpremote://?pasteboard=Data to paste to player
Start DVPRemote, send specified remote key press to the specified player, then call
exit the app by calling another URL (e.g. return to calling app):
dvpremote://Player Name?key=Key To Press&rurl=http://URL_To_Call
“Key to press” parameters
In the URL schemes, the following values can be submitted for “Key To Press”:
Home - sending this value for “Key to Press” presses the “Home” button in DVPRemote.
Rev - sending this value for “Key to Press” presses the “Rewind” button in DVPRemote.
Fwd - sending this value for “Key to Press” presses the “Fast Forward” button in DVPRemote.
Play - sending this value for “Key to Press” presses the “Play/Pause” button in DVPRemote.
Select - sending this value for “Key to Press” presses the “Select” button in DVPRemote.
Left - sending this value for “Key to Press” presses the “Left” button in DVPRemote.
Right - sending this value for “Key to Press” presses the “Right” button in DVPRemote.
Down - sending this value for “Key to Press” presses the “Down” button in DVPRemote.
Up - sending this value for “Key to Press” presses the “Up” button in DVPRemote.
Back - sending this value for “Key to Press” presses the “Back” button in DVPRemote.
InstantReplay - sending this value for “Key to Press” presses the “instant replay” button in DVPRemote. This is equivalent to a 30 second rewind with no buffering.
Info - sending this value for “Key to Press” presses the “Info” button in DVPRemote. (The button with the “*” used to re-arrange channels.)
Backspace - sending this value for “Key to Press” sends a “backspace” in text entry screens.
Enter - sending this value for “Key to Press” an “enter” in text entry screens.
Lit_ - sending this value for “Key to Press” sends the character after the “_”. For example, “Lit_r” sends the character “r”.
“Channel to select” parameter
In the URL schemes, the “Channel to Select” parameter should be set to the name of the channel to switch to. The name is the one found underneath the Icon on the Roku or in the Channel List presented by DVPRemote. Special characters in the channel name should be URL encoded (e.g. use %20 instead of space).
“Player Name” parameter
In the URL schemes, the “Player Name” parameter should be set to the name of the player which is to be controlled. Special characters in the player name should be URL encoded (e.g. use %20 instead of space).