|
|
| Line 82: |
Line 82: |
| | Now go to '''Step 2 - Parameterise VRTool'''. | | Now go to '''Step 2 - Parameterise VRTool'''. |
| | |} | | |} |
| − |
| |
| − | ====Using Google Chrome====
| |
| − | [[File:IconGoogleChrome.gif]] ''Current for version 39.0.2171.65.''
| |
| − |
| |
| − | '''In your web browser:'''
| |
| − | * If your Virtual Regatta game console is already open then close it.
| |
| − | * In your browser go to the Virtual Regatta page where you can see the [[File:ButtonVRPlay.gif|sub]] button which starts the game. Don't click on it yet.
| |
| − | * In the top right corner of the browser click the [[File:ChromeMenu.gif|sub]] menu button and select '''Tools''' --> '''More tools''' --> '''Developer tools'''. A window called '''Developer Tools''' opens in a separate window.
| |
| − | '''In the Developer Tools window:'''
| |
| − | * On the menu bar click '''Network'''.
| |
| − | * On the toolbar click on [[File:ChromeClear.gif|sub]] to clear any current traces.
| |
| − | * On the toolbar check that the [[File:ChromeRecord.gif|sub]] Record Network Log button is red. If it's not then click on it to turn it on.
| |
| − | '''In the Virtual Regatta window:'''
| |
| − | * Click on the [[File:ButtonVRPlay.gif|sub]] button to start the game console for your game. Log in if you have to.
| |
| − | '''In the Developer Tools window:'''
| |
| − | * The calls made by the game console to the game server are displayed.
| |
| − | * On the toolbar click on the [[File:ChromeFilter.gif|sub]] Filter tool. In the filter box type "Service" (without the quotes).
| |
| − | * Scroll down and look for the record that starts with ''"ServiceCaller.php?service=GetUser&id_user=...."''. This is the call that the game console used to retrieve your boat information from the game server.
| |
| − | * Right-click on the record and select '''Copy link address'''.
| |
| − | Now go to '''Step 2 - Parameterise VRTool'''.
| |
| − |
| |
| − | ====Using Internet Explorer====
| |
| − | [[File:IconInternetExplorer.gif]] ''Current for version 11.0.9600.17420.''
| |
| − |
| |
| − | '''In your web browser:'''
| |
| − | * If your Virtual Regatta game console is already open then close it.
| |
| − | * In your browser go to the Virtual Regatta page where you can see the [[File:ButtonVRPlay.gif|sub]] button which starts the game. Don't click on it yet.
| |
| − | * Press the '''F12''' key. A new window called '''F12 Developer Tools''' opens. If the new windows opens in the game window click on the [[File:IEUnpin.gif|sub]] '''Unpin''' tool in the tool bar and drag it clear.
| |
| − | '''In the Developer Tools window:'''
| |
| − | * On the left sidebar click in the [[File:IENetwork.gif|sub]] '''Network''' tool.
| |
| − | * On the top toolbar, if you can see the [[File:IECapture.gif|sub]] Capture button then click on it to turn on capturing.
| |
| − | '''In the Virtual Regatta window:'''
| |
| − | * Click on the [[File:ButtonVRPlay.gif|sub]] button to start the game console for your game. Log in if you have to.
| |
| − | '''In the Developer Tools window:'''
| |
| − | * The calls made by the game console to the server are displayed.
| |
| − | * In the [[File:IESearch.gif|sub]] search box type "getuser" (without the quotes) and click on the search tool. You should see the details of a request header with a Request key starting:
| |
| − | *: ''"GET /core/Service/ServiceCaller.php?service=GetUser&id_user=...."''
| |
| − | : This is the call that the game console used to retrieve your boat information from the game server.
| |
| − | * In the menu bar at the top click on '''SUMMARY'''. In the summary list the selected GetUser record will be highlighted.
| |
| − | * Right-click on the record and select '''Copy URL'''.
| |
| − | Now go to '''Step 2 - Parameterise VRTool'''.
| |
| − |
| |
| − | ====Using Firefox====
| |
| − | [[File:IconFirefox.gif]] ''Current for version 34.0.5.''
| |
| − |
| |
| − | '''In your web browser:'''
| |
| − | * If your Virtual Regatta game console is already open then close it.
| |
| − | * In your browser go to the Virtual Regatta page where you can see the [[File:ButtonVRPlay.gif|sub]] button which starts the game. Don't click on it yet.
| |
| − | * In the top right corner of the browser click the [[File:ChromeMenu.gif|sub]] menu button, then click on [[File:FirefoxDeveloper.gif|sub]] '''Developer''' and select '''Inspector'''. A window called '''Inspector''' opens. If the Inspector opens within the game window click on [[File:FirefoxWindow.gif|sub]] on the toolbar to show it in a separate window.
| |
| − | '''In the Inspector window:'''
| |
| − | * On the top menu bar click '''Network'''.
| |
| − | * Click on '''Clear''' at the bottom right to clear any current traces.
| |
| − | '''In the Virtual Regatta window:'''
| |
| − | * Click on the [[File:ButtonVRPlay.gif|sub]] button to start the game console for your game. Log in if you have to.
| |
| − | '''In the Inspector window:'''
| |
| − | * The calls made by the game console to the game server are displayed.
| |
| − | * On the bottom menu bar click on '''Other''' to show the XML calls.
| |
| − | * Find the record that starts with ''"ServiceCaller.php?service=GetUser&id_user=...."''. This is the call that the game console used to retrieve your boat information from the game server.
| |
| − | * Right-click on the record and select '''Copy URL'''.
| |
| − | Now go to '''Step 2 - Parameterise VRTool'''.
| |
| | | | |
| | ===Step 2: Parameterise VRTool=== | | ===Step 2: Parameterise VRTool=== |
games only. It requires VRTool version 2.06 or later. This page is adapted from instructions provided by
This page describes how to import boat data directly from the VR game server. Once it's set up the method is completely automatic and reliable. This is the best way to import data from VR games.
When your game console needs information about your boat it instructs your browser to send a request to the VR game server. The game server has to know who you are, so the request includes your username as an encrypted string. This means the request is unique to each player (and to each race). If you want
to request data from the server you have to figure out the contents of the request message for your boat. Fortunately you can use the developer tools built into modern browsers to "sniff" out the request on its way to the server.
Once you have found the request string for your boat you can configure VRTool to send the same request to the VR server. This configuration is done in the Boat Data control panel on the Boats tab. The game server responds with the data for your boat (and your friends if you want it). VRTool uses this to generate a track for each boat on the chart.
There are two main steps to establishing a link between VRTool and the Virtual Regatta game server:
These steps are explained in the following sections.
This is the trickiest part of the process, especially if you are not a little bit "geek". The process depends on which web browser you are using.
Some browsers are continually upgraded, and the developer tools in web browsers change with every update. So it's next to impossible to keep these instructions exactly up to date. The browser version for which the instructions have been tested is shown for each browser.
|
 Google Chrome
Current for version 39.0.2171.65.
|
 Internet Explorer
Current for version 11.0.9600.17420.
|
 Firefox
Current for version 34.0.5.
|
|
In your web browser:
- If your Virtual Regatta game console is already open then close it.
- In your browser go to the Virtual Regatta page where you can see the
 button which starts the game. Don't click on it yet.
|
- In the top right corner of the browser click the
 menu button and select Tools --> More tools --> Developer tools. A window called Developer Tools opens in a separate window.
In the Developer Tools window:
- On the menu bar click Network.
- On the toolbar click on
 to clear any current traces.
- On the toolbar check that the
 Record Network Log button is red. If it's not then click on it to turn it on.
|
- Press the F12 key. A new window called F12 Developer Tools opens. If the new windows opens in the game window click on the
 Unpin tool in the tool bar and drag it clear.
In the Developer Tools window:
- On the left sidebar click in the
 Network tool.
- On the top toolbar, if you can see the
 Capture button then click on it to turn on capturing.
|
- In the top right corner of the browser click the menu button, then click on
 Developer and select Inspector. A window called Inspector opens. If the Inspector opens within the game window click on  on the toolbar to show it in a separate window.
In the Inspector window:
- On the top menu bar click Network.
- Click on Clear at the bottom right to clear any current traces.
|
|
In the Virtual Regatta window:
- Click on the button to start the game console for your game. Log in if you have to.
|
|
In the Developer Tools window:
- The calls made by the game console to the game server are displayed.
- On the toolbar click on the
 Filter tool. In the filter box type "Service" (without the quotes).
- Scroll down and look for the record that starts with "ServiceCaller.php?service=GetUser&id_user=....". This is the call that the game console used to retrieve your boat information from the game server.
- Right-click on the record and select Copy link address.
|
In the Developer Tools window:
- The calls made by the game console to the server are displayed.
- In the
 search box type "getuser" (without the quotes) and click on the search tool. You should see the details of a request header with a Request key starting:
- "GET /core/Service/ServiceCaller.php?service=GetUser&id_user=...."
- This is the call that the game console used to retrieve your boat information from the game server.
- In the menu bar at the top click on SUMMARY. In the summary list the selected GetUser record will be highlighted.
- Right-click on the record and select Copy URL.
|
In the Inspector window:
- The calls made by the game console to the game server are displayed.
- On the bottom menu bar click on Other to show the XML calls.
- Find the record that starts with "ServiceCaller.php?service=GetUser&id_user=....". This is the call that the game console used to retrieve your boat information from the game server.
- Right-click on the record and select Copy URL.
|
|
Now go to Step 2 - Parameterise VRTool.
|
Boats tab. Open the Boat Data control panel.
icon beside this control to send the GET message to the game server. If it's successful the field on the control panel will populate with your boat data. If you click the icon more than once in a 10 minute server cycle the data returned will a repeat of the previous data and it is ignored with the message "Same or old boat data".
Auto update in to make VRTool update the boat position automatically every 10 minutes, and draw the boat track on the chart.
