microsoft / media-app-samples-for-xbox

Sample apps showing how to build music and video apps for Xbox using a WebView.

description	languages	name	page_type	products	urlFragment
Sample showing how to build music and video apps using primarily web technologies for Xbox.	csharp cplusplus javascript html	Media App Sample for Xbox	sample	xbox	media-app-samples-for-xbox

Media App Samples for Xbox

This project contains two sample apps, a video player and a music player. Both apps are meant to be run on Xbox, and both are built primarily in JavaScript and HTML, running in a thin native wrapper containing a full-screen WebView. Both apps have samples using either C# or C++ for the native portion; use whichever language you prefer.

Note - These samples are targeted and tested for Windows 11 (10.0; Build 22000), and Visual Studio 2022.

These samples run on the Universal Windows Platform (UWP).

Features

These samples highlight the following topics:

• UWP on Xbox One
• Media Playback
• WebView2

Universal Windows Platform development

Prerequisites

• Windows 11. Minimum: Windows 11, version 22H2 (updated Oct 2023).
• Windows SDK. Minimum: Windows SDK version 10.0.22621 (Windows 11, version 22H2).
• Visual Studio 2022 You can use the free Visual Studio Community Edition to build and run Windows Universal Platform (UWP) apps.

To get the latest updates to Windows and the development tools, and to help shape their development, join the Windows Insider Program.

Running the samples

You can simply hit Start Debugging (F5) to try this sample on your local machine.

To test the app on an Xbox, you will need to enable Developer Mode on your Xbox. Then you can configure Visual Studio to deploy to it as a Remote Machine:

1. Right-click the main project in the Solution Explorer, and then select Properties.
2. Under Start options, change Target device to Remote Machine.
3. In Remote machine, enter the system IP address or hostname of the Xbox One console. For information about obtaining the IP address or hostname, see Introduction to Xbox One tools.
4. In the Authentication Mode drop-down list, select Universal (Unencrypted Protocol).

When you next hit Start Debugging (F5) it may ask you for a pairing PIN. This can be found in the Dev Home app on your Xbox.

Contributing

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

Trademarks

This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.

media-app-samples-for-xbox's Issues

Cannot see on teen account

When launching on xbox I can't see this app. Is there a way to change the content restrictions in the code? I tried changing the id, name, and certificate but it still says "Sorry, we can't show this"