XboxOne_DanielFurneaux_21.11.2023.pptx

XBOX How to guide Version 11/23 Table of Contents – Page 1/2 Click on hyperlink to access content • 1. Setting Up • Equipment • Setting Up Your Dev Kit Console - Xbox Series X - Xbox One X - Xbox Test Kit • Change the console language • Finding your IP Address • 3. Account Set Up • Account Set Up...

XBOX How to guide Version 11/23 Table of Contents – Page 1/2 Click on hyperlink to access content • 1. Setting Up • Equipment • Setting Up Your Dev Kit Console - Xbox Series X - Xbox One X - Xbox Test Kit • Change the console language • Finding your IP Address • 3. Account Set Up • Account Set Up on: • Xbox One Manager • New Xbox One Manager • Your Console • Account Management • Sandbox • Sending/Accepting Friend Invites • 2. Xbox One Manager • Oldest version VS New • How to install New Xbox One Manager • Connect your console on: • Xbox One Manager • New Xbox One Manager • 4. Testing • Viewing Achievements • Save Data Management Table of Contents – Page 2/2 Click on hyperlink to access content • 5. Capturing Media • Collecting Media • Using Remote Viewer • Media Location • 6. Debug Menu • • • • • Launch parameters Debug/Dev Settings Enabling Crash dumps (2 slides) Accessing Crash Dumps Profiling • 7. Troubleshooting • Troubleshooting • Initialising • 8. Switching Off • How to switch off Equipment Xbox One and Xbox X/S are set-up in exactly the same way. Please remember how your console was brought to you and what equipment went into what bag. This will be returned at the end of the day by you, and it will be checked to ensure it was packed away Setting Up Your Dev Kit Console: Xbox Series X Consoles 1. Plug the power cable into your desk outlet (ensure the power is off when you do this). 2. Connect the power cable to the console by plugging it into the back of the console. 3. Connect the ethernet cable to the Retail port – Not Debug. 4. Connect the HDMI cable to the console HDMI out port. 5. Connect the controller to the console via the USB cable. 6. When you have followed the above steps, you can turn your power on and turn the console on via the power button. If you are missing any cables or are otherwise stuck in the setup process, do let your senior and/or lead know so that the issue can be resolved. Back of Console 4 2 3 6 Front of Console 5 Setting Up Your Dev Kit Console: Xbox One X Consoles 1. Plug the power cable into your desk outlet (ensure the power is off when you do this). 2. Connect the power cable to the console by plugging it into the back of the console. 3. Connect the ethernet cable to the non-debug port. 4. Connect the HDMI cable to the console HDMI out port. 5. Connect the controller to the console via the USB cable. When you have followed the above steps, you can turn your power on and turn the console on via the power button. If you are missing any cables or are otherwise stuck in the setup process, do let your senior and/or lead know so that the issue can be resolved. Setting Up Your Dev Kit Console: Xbox One X Testkit Console 1. Plug the power cable into your desk outlet (ensure the power is off when you do this). 2. Connect the power cable to the console by plugging it into the back of the console. 3. Connect the ethernet cable. 4. Connect the HDMI cable to the console HDMI out port. 5. Connect the controller to the console via the USB cable. When you have followed the above steps, you can turn your power on and turn the console on via the power button. If you are missing any cables or are otherwise stuck in the setup process, do let your senior and/or lead know so that the issue can be resolved. Functions of the Xbox consoles 1. 2. 3. 4. HDMI Out. Ethernet in – Ensure that this is NOT the “Debug” port. Power cable which arrives in your cable/controller bag. Programable buttons which can be customised through the Xbox One Manger, or through the DEV home menu within the console. 5. Console name and number. 6. Wireless Sync button for controllers and other supported peripherals. 7. Reset button. DO NOT PRESS THIS. 8. Console power button and power LED. 9. Disc Tray ejector – likely will never be used. 10. DEV Display screen. Will usually display the console name and IP address, however it can be adjusted to show other things such as rendered FPS. 11. Joystick button for the Display (10). 12. Front USB ports. These functions are the same as what you will expect to see on an Xbox Series X|S Console. The only difference is that the X|S consoles have a simplified rear IO panel with USB-C connections. Change the console language 1 1.Select Launch Home from home XDK Quick actions box 2.Select Settings 3.Select System (3rd row) 4.Select Language & Location (3rd row on the first column) 2 3 4 5 5.Choose the language Finding your IP Address On the console display On the Console UI • Console display on front panel • When you have plugged in your ethernet cable, you should see your IP address on your Dev Kit display • DEV Home • Top-left-corner This method applies for both the Xbox One consoles and the Xbox X|S consoles. If an IP address is not present, double check that the Ethernet cable is properly seated within the Retail port – never Debug. Xbox One Manager Old Xbox One Manager is a powerful app that allows to use a lot of features such as capture media onto your PC, manage accounts, simulate network issues… This software is used for both Xbox One and Xbox X/S. To use this program, you will need your console’s IP Address. There is a new version for XboxOne Manager known as Xbox Manager GDK. Some testers find it more convenient and easier to use. The biggest difference is that it has a live recording feature. This guide will cover both: • Xbox One Manager: The oldest version. It should already be installed on your PC. • NEW Xbox One Manager: The newest version New NEW Xbox One Manager How to install it There is the latest version of Xbox One Manager. Some testers find it more convenient and easier to use. The biggest difference is that it has a live recording feature. How to download: Go to “S:\Console SDK's\Latest\Xbox\ Xbox 1 Manager”. Then copy and paste the whole folder “Xbox 1 Manager” into your PC (D drive recommended). How to launch the app: Go to the “bin” folder and click “XboxOneManager” Xbox One Manager Connect your console To connect the console with the PC: 1. Open Xbox One Manager on your PC 2. Click Add Console on the bottom-left-corner 3. Locate your Console IP Address on the console display 4. Enter your IP address in the “Host name or IP address” box 5. Select Add NEW Xbox One Manager Connect your console There is not much difference between the old and the latest one when it comes to how to use them. To connect the console with the PC: 1. Open Xbox One Manager on your PC. 2. Click this icon on the top-left-corner. 3. Locate your Console IP Address on the console display. 4. Enter your IP address in the “Enter a console IP or Name” box. 5. Select Add. Features and main control options The Xbox One Manager comes with a lot of tools and options. It may be unclear what is important at first. Here are the primary features you will be using: Console Selector Console Tools 1. 2. 3. 4. 5. You can connect to multiple consoles at once and control them individually Reboot Console Shutdown Console Explore File System Take Screenshot Record previous X seconds 6. Start/Stop Recording 7. Open Media Panel /. These are features you do not and should not use As for the tools you do not use, they are as follows: - Update System OS - Deploy or Install Application - Run Script - Apply Boot Script These tools are simply not used in general testing and should not be worried about. If a particular task requires use of these tools, please Account Set up You can set up your account and modify your sandbox by using: • Xbox Manager • NEW Xbox Manager • Your console Account Setup on Xbox One Manager​ Pre-Made Accounts No account - Guest If your project requires you to use a created account you can use Xbox One Manager to Sign in: Use the “Guest” option to quickly generate an account 1.Select Profiles Tab. 1. Select Profiles Tab. 2.Select +Guest. 2. Select +User. 3. Input the e-mail address and1 password provided. 2 3 Account Setup on NEW Xbox One Manager​ Pre-Made Accounts No account - Guest If your project requires you to use a created account you can use Xbox One Manager to Sign in: Use the “Add Guest” option to quickly generate an account 1. Select Home Tab. 2. Select Add Guest. 2. Select Add User. 1 3. Input the e-mail address and password provided. 2 1. Select Home Tab. 3 Account Setup on the Console Pre-Made Accounts No account - Guest If your project requires you to use a created account: Use the “Guest” feature - which will generate an account for you. 1. Go to Home on Xbox One manager UI. 2. Select Add existing on Test accounts box. 3. Input the e-mail address and password provided. 1. Go to Home on Xbox One manager UI. 2. Select Add guest on Test accounts box. Account Management Xbox One Manager NEW Xbox One Manager • Right click over user details to: • Select appropriate option to: • Sign Out. • Set Default user. • Remove User From Console. • Remove (Sign Out). • Auto Sign-in (Set a default user). Sandbox Some projects will need to set a specific Sandbox. You can modify it on Xbox One Manager or on the Console. •On the Xbox One Manager •Settings / Device information. Enter the sandbox details in the "Sandbox ID" box and select "Save". •On the NEW Xbox One Manager •Settings / Device information. Enter the sandbox details in the "Sandbox ID" box and select "Save". 1 2 2 3 1 • On the Console UI • Home / Change Sandbox Sending/Accepting Friend Invites You may be required to add other testers as friends on the console in order to test multiplayer features. This can usually be done in-game but we may have to add them on the hardware itself. In order to do this: 1. First press the Xbox button on the controller. 2. Press the RB (right bumper) button to tab over to the People tab. 3. Select Find Someone. 4. Enter their Gamertag (typically in the format 2 Dev XXXXXXXXX). 5. Choose their profile and select Add Friend and then Submit. Once an invite has been sent, it can be accepted by pressing the Xbox button and selecting the bell icon in the bottom left. This allows you view all notifications including friend requests. Simply accept the friend request and you should be good to go! Viewing Achievements Sometimes we are asked to complete achievements as part of the testing process. We need to check that they unlock under the correct circumstances. Viewing achievements is a fairly simple process: 1. First press the Xbox button on the controller. 2. Press the RB (right bumper) button to tab over to the Game Activity tab. 3. Select All achievements and simply select the game you want to view achievements for. All achievement details are displayed next to the achievement thumbnail – unlock requirements, date achieved etc. Locked achievement thumbnails appear greyed-out. Certain achievements are secret and do not tell you the requirements for unlocking. Either the client will tell you the requirements for unlocking them or they can be selected with the A button. Upon selection, there will be an option to “Reveal details” which should then show you their unlocking requirements. Save Data Management You may be required to delete your save data as part of the testing process. This can be done in two ways: 1. From the Xbox home screen highlight the game you want to delete save data from and press the Options button. 2. Then select Manage game and add-ons. 3. From here select Saved data and simply select the data you want to delete or DELETE ALL if applicable. Alternatively, 4. Press the Xbox button. 5. Select My games & apps. 6. Select See all and then Games. 7. Highlight the game you want to delete save data from and follow the process above. Collecting Media You can take videos and screenshots using Xbox One Manager. Xbox One Manager NEW Xbox One Manager 1 Use the dropdown to select how far back you want the video to record – up to a maximum of 5 minutes. For example, upon clicking the video camera button after selecting 5 minutes, the media will capture from 5 minutes in the past, up to the point the camera icon was pressed. It does not record in real- 2 3 1. Screenshots 2. Record from past activity 3. Live recording Using Remote Viewer NEW Xbox One Manager 1 only In addition to sending inputs to the console, you can use the Remote Control tab to show what is on the console’s screen in real time. You can use this feature while using live recording. To Remote Viewer: 1. Select “Remote Control” 2. Expand the remote screen Click icon to2 add picture Media Location Default Media folder for screenshots and videos: C:\Users\YourUser\OneDrive Universally Speaking Ltd\Pictures\ 1 Xbox One Manager\Media You can also open the media location by double clicking on the video or screenshot. You can change the default media folder in the NEW Xbox One Manager. 2 Launch parameters NEW Xbox One Manager only When you launch an app, you can specify launch parameters using the Parameters box to utilise specific debugs while testing. 1. Select Home Tab 2. Select an application 3. Enter Parameters into the box 4. Click the three dots 5. Select Launch Debug/Dev Settings You can modify/set features in this menu. Networking You can simulate different situations as “no connection” or “slow connection”. Debug settings – Crash dump type Setting this to “Mini” will ensure the correct file type is generated if and when the title crashes. See “Enabling Crash Dumps” for more information. Profiling Modes Xbox Series X dev consoles can be set-up to act other consoles within the Xbox family. The profile can be changed so the console acts like a Series S or an Xbox One. See “Profiling” for more information. Enabling Crash dumps Part 1 The Xbox doesn’t automatically generate crash dump files. This can be a problem if we experience a crash in-game. In order for crash dumps to be generated we must enable a few settings BEFORE we start testing. From the Dev Home screen: 1. Select Settings. 2. Highlight the Debug settings dropdown. 3. From here, change the crash dump type to Mini. Enabling Crash dumps Part 2 Now we need to change some settings within the Xbox One Manager. 1 Click icon to add 2 picture For both versions of Xbox One Manager: 1. Select the connected console from the left. 3 2. Select Settings (the location of Settings is slightly different on the new version but the process is the same). 4 3. Click on the Debug tab. 4. Ensure the crash dump type is set to Mini. 5. Tick the Crash dump upload box. 5 Accessing Crash Dumps When a title crashes we need to be able to access the files that are created. The way we do so differs between the old and new versions of Xbox One Manager. Old New 1. Select the Browse console files button on the top taskbar. 1. Right click on the console. 2. Within the file explorer pop-up select SystemScratch. 3. Select the file relating to crashes – usually called LocalDumps. 2. Select Browse console files. 3. Within the file explorer pop-up select SystemScratch. 4. Select the file relating to crashes – usually called LocalDumps. Profiling An Xbox Series X dev console can run in different Profiling Modes. These profiles mean that the console can accurately behave like other consoles in the Xbox family. This can affect how a game behaves so on rare occasions you may be asked to change the environment. The environments are as follows: Anaconda – Native Xbox Series X Lockhart – Xbox Series S Scarlett – Xbox One To change the Profiling Mode: 1. From the Dev Home Menu select Performance. 2. Select the Console Mode dropdown. 3. Choose the Profiling Mode required. 4. The console will restart to reflect your changes. Troubleshooting Network issues/ disconnections: if you are experiencing connection problems be sure the Network Simulation is off. 1. Go to the Debug Menu 2. Select Networking 3. Check that Network Simulation is off If simulation is on “No connection” or “Minimum supported” could cause network problems. Also ensure the ethernet cable is in the correct port. If the title cannot be accessed: 4. Ensure the Sandbox is correct. 5. Ensure you are using the correct Xbox account assigned to you for the project. 6. Ensure the profiling environment is correct. See “Profiling” for more information Initialising You may be required to initialise your console before returning it to Build and Distribution. This is so your console can be used by other testers without breaching NDA. To initialise an Xbox: 1. First go to Settings. 2. Select System from the list on the left and select Console info. 3. From here, select Reset console. 4. Select RESET AND REMOVE EVERYTHING and your console will initialise. Do not be concerned if your console restarts after initialising, this is normal. Switching Off the Console To switch off the console correctly: 1. Press the Xbox Button 2. Scroll down and select the Power Icon 3. Select Turn off console 4. Important: Wait until the console is completely turned off before unplugging it from the power supply. Alternatively, press and hold the Xbox button and select “Turn off console”. THANK YOU We want to keep this guide up to date and relevant for all departments. Want to add or edit some information? Want to remove outdated information? Send an email to [email protected] with the subject: How to guide – Suggestion – [HowtoguideName]