page_type: guide languages:
- javascript products:
-
azure media services description: "This repository contains samples, documentation and test results for different 3rd party player frameworks using VOD and Live content from Azure Media Services (AMS)." urlFragment: "media-services-3rdparty-player-samples"
Media Services 3rd Party Player Samples
IMPORTANT NOTE : Azure Media Services have been retired on June 30, 2024. Please see the retirement guide.
Overview
This repository contains samples, documentation, and platform/browser feature tables for using popular 3rd party player frameworks that support HLS and/or MPEG-DASH delivery from Azure Media Services (AMS).
These are the main components of this repository:
Set up
This project uses PowerShell setup scripts to generate content (VOD and Live) in Azure Media Services and provides tools to test the 3rd party players in different combinations of features, streaming formats, and content protection.
For example, this is the Index page generated after running the setup scripts. It contains the playback endpoints for all the features, formats, and content protection options available in Azure Media Services along with links to test them on each 3rd party player sample:
Samples
The repository contains a sample implementation of each player. The sample is a minimal player implementation using captioning and content protection (DRM and Encryption).
To see the sample code, please check:
- Video.js
- Shaka Player
- hls.js
- dash.js
- ExoPlayer
- AVPlayer
- THEOplayer
- NexPlayer
Test results
The samples were tested with VOD and Live content generated with the setup script in the following browsers:
- Windows 10 v1909+
Chrome (v83.0.4103.97+)
Firefox (v77.0.1+)
Edge Chromium-based (v83.0.478.50+)
Edge (v44.18362.449.0+)
- macOS v10.15.5+
- Chrome (v83.0.4103.97+)
Safari (v13.1.1+)
- Ubuntu v18.04.3 LTS+
- Chrome (v79.0.3945.130+)
- Firefox (v76.0.1+)
- Android v8+
- Chrome (v83.0.4103.97+)
- Firefox (v68.9+)
- iOS v13.5.1+
- Chrome (v83.0.4103.88+)
- Safari (v13.1+)
To see the test results, please check:
How to set up your player
To set up your player, follow the below instructions:
- How to use the Video.js player with Azure Media Services
- How to use the Shaka player with Azure Media Services
- How to use the hls.js player with Azure Media Services
- How to use the dash.js player with Azure Media Services
- How to use the ExoPlayer with Azure Media Services
- How to use the AVPlayer with Azure Media Services
- How to use the THEOplayer with Azure Media Services
- How to use the NexPlayer with Azure Media Services
Root contents
| File/folder | Description |
|---|---|
src |
Folder with 3rd party player samples |
docs |
Folder with test results |
setup |
Folder with AMS setup scripts |
.gitignore |
Define what to ignore at commit time |
CHANGELOG.md |
List of changes to the sample |
CONTRIBUTING.md |
Guidelines for contributing to the sample |
LICENSE |
The license for the sample |
README.md |
This README file |
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 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 opencode@microsoft.com with any additional questions or comments.