Please Select Your Location
Australia
Österreich
België
Canada
Canada - Français
中国
Česká republika
Denmark
Deutschland
France
HongKong
Iceland
Ireland
Italia
日本
Korea
Latvija
Lietuva
Lëtzebuerg
Malta
المملكة العربية السعودية (Arabic)
Nederland
New Zealand
Norge
Polska
Portugal
Russia
Saudi Arabia
Southeast Asia
España
Suisse
Suomi
Sverige
台灣
Ukraine
United Kingdom
United States
Please Select Your Location
België
Česká republika
Denmark
Iceland
Ireland
Italia
Latvija
Lietuva
Lëtzebuerg
Malta
Nederland
Norge
Polska
Portugal
España
Suisse
Suomi
Sverige

Setting up Marker-Based Location Sharing with VIVE Business Streaming

Use VIVE Business Streaming to set up Marker-Based Location Sharing for PC VR headsets.
Note: Marker-Based Location Sharing can only be used with headsets enrolled in VO Mode. For details, see Visual Odometry (VO) Mode.
  1. Set up the headsets you'll use in the play area. See Setting up the headsets.
  2. Create your ArUco markers. See Creating ArUco markers for Marker-Based Location Sharing.
  3. Optional: Set the tracking origin of your virtual scene. This will be used to align the height of the virtual scene according to the height of the marker you create. See Aligning the height of a virtual scene using an ArUco marker for details.
  4. Place the primary marker in your play area in a central location. You can put it on the floor or wall, as long as it is clearly visible.
  5. If you're using two markers, place the secondary marker in the play area. Make sure it's at least 150 cm away from the primary marker.
  6. Do one of the following:
    • Save markers_list.json to a designated file path on your computer and insert the file path in the corresponding API. The headset's tracking engine will retrieve the marker settings from the JSON file on your PC.
    • Insert the marker settings from markers_list_escape.json directly into the corresponding API embedded in your application's code.

    For details, see Marker-Based Location Sharing APIs (PC VR).

  7. Add the files needed to utilize the VIVE Streaming PC SDK to your assets and plugins folders. You can find these files and the VIVE Streaming PC SDK Programming Guide on the VIVE Forum.
  8. Initialize the connection between VIVE Business Streaming and the app you're streaming with the following API:
    private void OnEnable()
    {
    VS_Init();
    pServerStatusCB = OnServerStatusUpdate;
    pSettingChangeCB = OnSettingChange;
    pSdkDebugLogCB = OnSdkDebugLog;
    VS_SetCallbackFunction(pServerStatusCB, pSettingChangeCB, pSdkDebugLogCB);
    OnVbsIsRunning += Testing_OnVbsIsRunning;
    }
    
  9. Connect your headset to your computer using a USB Type-C cable.
  10. Open VIVE Business Streaming on your PC and make sure it's updated to the latest version.
  11. Install the latest version of the VIVE Business Streaming VR app on your headset.
  12. Open SteamVR and start streaming your desired app or game.
  13. Move to the play area and scan the marker (or markers). Location sharing will start automatically.
Note:
  • If you've updated the marker settings JSON file markers_list.json, restart VIVE Business Streaming on your computer and headset and then restart SteamVR to apply the changes.
  • If you move to a different position in the play area while running a game or app, restart VIVE Business Streaming on the headset to reset your position in VR.
  • After you scan a marker, marker detection will be disabled on the headset. You can re-enable marker detection by restarting VIVE Business Streaming on the headset.
  • Location sharing is not affected by SteamVR activity, including switching games or apps, closing a game or app and returning to SteamVR home, or restarting SteamVR.
  • If you restart your headset or restart VIVE Business Streaming on the headset, you'll need to scan the ArUco markers again to resume location sharing.
Submit
Thank you! Your feedback helps others to see the most helpful information.