Xbox One - Troubleshooting

If you cannot find the solution to your problem in the troubleshooting section, please contact us.

Restart SuitestDrive

Restart SuitestDrive after applying any fixes to allow changes to take effect.


Cannot control Xbox One via Virtual Remote Controller (VRC)

Verify your Xbox One OS version is at a minimum or higher of:

  • Developer kits - OS version 10.0.15063 or higher
  • Retail versions - OS version 10.0.17134 or higher

Refer to Xbox One operating system versions and system updates if you require guidance on checking the OS version and updating to the latest.

If your Xbox One is at the correct OS version then please verify that your device is currently in developer mode. If you are unsure on how to switch to developer mode on your Xbox One retail version then please refer to Xbox One Developer Mode activation.

Account not signed in or credentials changed

If you receive the Account needs to be signed in on target device. error during the open app operation then the account is not signed in on the Xbox One. Either sign in the account manually or enable instant sign-in.

If you receive the Credentials for Xbox Device Portal were changed. error during open app operation then the Xbox Device Portal credentials that were initially set when adding the device have been changed (e.g. password for the account). To solve this error, either revert the account settings to the ones initially set or remove the device and re-add it using the new credentials. You will find that the Xbox One becomes unresponsive if the above error occurs.

Failed to communicate with your Xbox

If you get the Failed to communicate with your Xbox message at the last step of adding an Xbox One please check the following:

  • Xbox One console is powered on and has an active Internet connection.

  • Device is in Developer mode and you have enabled the Xbox Device Portal.

  • The Xbox One console IP address you specified in Suitest is correct and reachable from the machine hosting SuitestDrive. To check this type https://XXX.XXX.XXX.XXX:11443 (replace the X's with the actual IP address) in the browser on host computer and check if the Xbox Device Portal interface opens.

Instrumenting HTML5 local context app for OS version 10.0.17763.2023

Due to issues with Xbox API for this OS version we are unable to upload our instrumentation library automatically. To work around this issue, please do the following:

  1. Download our instrumentation library.

  2. Insert the file into your Visual Studio project folder.

    Visual Studio project folder - suitest.js inserted
    Visual Studio project folder - suitest.js inserted
  3. In properties of the suitest.js file change the property Package Action so that it is set to Content.

    suitest.js > Properties > Package Action > Content
    suitest.js > Properties > Package Action > Content
  4. Insert the following snippet into every HTML page which you would like to test. The snippet assumes that the file suitest.js is place in the root folder of your project, if that is not the case please correct the path in src.

    <script src="/suitest.js"></script>
    
  5. Whitelist Suitest domains in the Package.appxmanifest under the Content URIs section:

    Whitelist - https://*.suite.st
    Whitelist - https://*.suite.st
  6. Update the package manifest:

    In Visual Studio, navigate to your app's project manifest (Package.appxmanifest) then select the Capabilities tab, and check Internet (Client).