Skip to content

Commit 2de461b

Browse files
acrolinx warning fixes. Added missing files. Moved typescript to samples.
1 parent f80d656 commit 2de461b

14 files changed

+379
-2349
lines changed

articles/media-services/azure-media-player/TOC.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@
2727
- name: Accessibility
2828
href: azure-media-player-accessibility.md
2929
- name: Writing Plugins
30-
href: azure-media-player-writing-plugins-
30+
href: azure-media-player-writing-plugins.md
3131
- name: Plugin gallery
3232
href: azure-media-player-plugin-gallery.md
3333
- name: Localization

articles/media-services/azure-media-player/azure-media-player-changelog.md

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -66,8 +66,9 @@ ms.date: 03/16/2020
6666

6767
### Changes ###
6868

69-
<!---API needs onboarding--->
70-
-[Change][Live captioning] Changed API name for CEA captions from 608 to 708, for more details, see [here](index.html#amp.player.cea708captionssettings)
69+
<!---API needs onboarding. Removed link until this happens to get doc to pass Acrolinx--->
70+
-[Change][Live captioning] Changed API name for CEA captions from 608 to 708.
71+
<!--> for more details, see [here](index.html#amp.player.cea708captionssettings)-->
7172

7273
## 2.2.0 (Official Release) ##
7374

@@ -92,7 +93,7 @@ ms.date: 03/16/2020
9293

9394
### Changes 2.1.9 ###
9495

95-
- [Change][Flash][AES] Modified Flash tech logic to not use sharedbytearrays for AES decryption as Adobe has blocked the usage as of Flash 30. Please note, playback will only work once Adobe deploys a new version of Flash due to a bug in v30. Please see [known issues](known_issues.html) for more details
96+
- [Change][Flash][AES] Modified Flash tech logic to not use sharedbytearrays for AES decryption as Adobe has blocked the usage as of Flash 30. Please note, playback will only work once Adobe deploys a new version of Flash due to a bug in v30. Please see [known issues](azure-media-player-known_issues.md) for more details
9697

9798
## 2.1.8 (Official Update) ##
9899

@@ -342,9 +343,10 @@ ms.date: 03/16/2020
342343
## 1.7.2 (Official Hotfix Update) ##
343344

344345
### Features 1.7.2 ###
345-
<!---API needs onboarding--->
346+
<!---API needs onboarding. Removed link to API until remedied.--->
346347
- [Feature][AzureHtml5JS|Firefox] Enable Widevine playback with EME for Firefox 47+
347-
- [Feature] Add event for player ([disposing](index.html#static-amp.eventname.disposing))
348+
- [Feature] Add event for player disposing
349+
<!-- ([disposing](index.html#static-amp.eventname.disposing)) -->
348350

349351
### Bug Fixes 1.7.2 ###
350352

@@ -380,9 +382,9 @@ ms.date: 03/16/2020
380382
## 1.7.0 (Official Update) ##
381383

382384
### Features 1.7.0 ###
383-
<!---API needs onboarding--->
385+
<!---API needs onboarding. Removed link until remedied.--->
384386
- [Feature][AzureHtml5JS][FlashSS] Added currentMediaTime() to get the encoder media time of the current time in seconds
385-
- [Feature][FlashSS] Implemented download telemetry APIs with videoBufferData() and audioBufferData() (see [BufferData](index.html#amp.bufferdata) for more details)
387+
- [Feature][FlashSS] Implemented download telemetry APIs with videoBufferData() and audioBufferData()<!-- (see [BufferData](index.html#amp.bufferdata) for more details) -->
386388
- [Feature][FlashSS] Added 'downloadbitratechanged' event
387389
- [Feature] Loading time improved compared to older versions of player
388390
- [Feature] Errors are logged to JavaScript console

articles/media-services/azure-media-player/azure-media-player-known-issues.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -42,8 +42,8 @@ The current release has the following known issues:
4242
- If in the DVR window of Live content, and content finishes, timeline will continue to grow until seek to the area or reaching the end of the presentation.
4343
- Live presentations in Firefox with MSE enabled has some issues
4444
- Assets that are audio or video only will not play back via the AzureHtml5JS tech.
45-
- If you'd like to play back assets without audio or video, you can do so by inserting blank audio or video using the [Azure Media Services Explorer tool](http://aka.ms/amse)
46-
- Instructions on how to insert silent audio can be found [here](https://azure.microsoft.com/en-us/documentation/articles/media-services-advanced-encoding-with-mes/#silent_audio)
45+
- If you'd like to play back assets without audio or video, you can do so by inserting blank audio or video using the [Azure Media Services Explorer tool](https://aka.ms/amse)
46+
- Instructions on how to insert silent audio can be found [here](https://azure.microsoft.com/documentation/articles/media-services-advanced-encoding-with-mes/#silent_audio)
4747

4848
## Flash ##
4949

articles/media-services/azure-media-player/azure-media-player-license.md

Lines changed: 309 additions & 0 deletions
Large diffs are not rendered by default.

articles/media-services/azure-media-player/azure-media-player-options.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -99,7 +99,8 @@ By setting this option to true video element will take full width of the parent
9999

100100
`<video ... data-setup='{"playbackSpeed": {"enabled": true}}'>`
101101

102-
Other properties of the `playbackSpeed` setting are given by [PlaybackSpeedOptions](#amp.player.playbackspeedoptions) object. Example of setting playback speed options in JavaScript:
102+
<!-- API needs onboarding. Commented sentence until remedied. -->
103+
<!--Other properties of the `playbackSpeed` setting are given by [PlaybackSpeedOptions](#amp.player.playbackspeedoptions) object.--> Example of setting playback speed options in JavaScript:
103104

104105
```javascript
105106
var myPlayer = amp('vid1', {
Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
---
2+
title:
3+
description:
4+
author: IngridAtMicrosoft
5+
ms.author: inhenkel
6+
ms.service: media-services
7+
ms.topic: overview
8+
ms.date: 03/16/2020
9+
---
10+
11+
# Azure Media Player overview #
12+
13+
Azure Media Player is a web video player built to playback media content from [Microsoft Azure Media Services](http://azure.microsoft.com/en-us/services/media-services/) on a wide variety of browsers and devices. Azure Media Player utilizes industry standards, such as HTML5, Media Source Extensions (MSE) and Encrypted Media Extensions (EME) to provide an enriched adaptive streaming experience. When these standards are not available on a device or in a browser, Azure Media Player uses Flash and Silverlight as fallback technology. Regardless of the playback technology used, developers will have a unified JavaScript interface to access APIs. This allows for content served by Azure Media Services to be played across a wide-range of devices and browsers without any extra effort.
14+
15+
Microsoft Azure Media Services allows for content to be served up with DASH, Smooth Streaming and HLS streaming formats to playback content. Azure Media Player takes into account these various formats and automatically plays the best link based on the platform/browser capabilities. Microsoft Azure Media Services also allows for dynamic encryption of assets with common encryption (PlayReady or Widevine) or AES-128 bit envelope encryption. Azure Media Player allows for decryption of PlayReady and AES-128 bit encrypted content when appropriately configured. See the [Protected Content](azure-media-player-protected-content.md) section for how to configure this.
16+
17+
To request new features, provide ideas or feedback, please submit to [UserVoice for Azure Media Player](http://aka.ms/ampuservoice). If you have and specific issues, questions or find any bugs, drop us a line at [email protected].
18+
19+
[Sign up](http://aka.ms/ampsignup) to never miss a release and to stay up to date with the latest that Azure Media Player has to offer.
20+
21+
Please note that Azure Media Player only supports media streams from Azure Media Services.
22+
23+
## License ##
24+
25+
Azure Media Player is licensed and subject to the terms outlined in the Microsoft Software License Terms for Azure Media Player. Please see [license file](azure-media-player-license.md) for full terms. Please see the [Privacy Statement](http://www.microsoft.com/en-us/privacystatement/default.aspx) for more information.
26+
27+
Copyright 2015 Microsoft Corporation.
28+
29+
## Next steps ##
30+
31+
- [Azure Media Player Quickstart](azure-media-player-quickstart.md)

articles/media-services/azure-media-player/azure-media-player-playback-technology.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ ms.topic: overview
88
ms.date: 03/16/2020
99
---
1010

11-
# Playback Technology ("Tech") #
11+
# Playback technology ("Tech") #
1212

1313
Playback Technology refers to the specific browser or plugin technology used to play the video or audio.
1414

@@ -58,11 +58,12 @@ Given the recommended tech order with streaming content from Azure Media Service
5858
5959
<sup>2</sup> Successful playback on Android devices requires a combination of device capabilities, graphics support, codec rendering, OS support and more. Since Android is an open source platform which allows phone manufacturers to change the Vanilla Android OS provided by Google, this cause some fragmentation in the Android space, and some devices may not be supported because of lack of features. Also, some Android devices do not have support for all codecs.
6060
61-
<sup>3</sup> In the cases where there is no support for token, a proxy can be used to add this functionality. Check out this [blog](http://azure.microsoft.com/blog/2015/03/06/how-to-make-token-authorized-aes-encrypted-hls-stream-working-in-safari/) to learn more about this solution.
61+
<sup>3</sup> In the cases where there is no support for token, a proxy can be used to add this functionality. Check out this [blog](https://azure.microsoft.com/blog/2015/03/06/how-to-make-token-authorized-aes-encrypted-hls-stream-working-in-safari/) to learn more about this solution.
6262
63-
>[!NOTE]
63+
> [!NOTE]
6464
> If the expected tech chosen requires a plugin be installed, like Flash, and that is not installed on the user's machine, AMP will continue to check the capabilities of the next tech, in conjunction with source types and protection info, in the tech list. For example, if attempting to view an unprotected on-demand stream in Safari 8 on OS X Yosemite, and both Flash and Silverlight are not installed, AMP will select the native Html5 tech for playback.
65-
>[!NOTE] New browser technologies are emerging daily, and as such could affect this matrix.
65+
> [!NOTE]
66+
> New browser technologies are emerging daily, and as such could affect this matrix.
6667
6768
## Next steps ##
6869

articles/media-services/azure-media-player/azure-media-player-plugin-gallery.md

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,6 @@ ms.topic: overview
88
ms.date: 03/16/2020
99
---
1010

11-
1211
# Azure Media Player Plugin Gallery #
1312

1413
## Plugins ##
@@ -20,18 +19,18 @@ ms.date: 03/16/2020
2019
| Sprite Tip | [Demo](http://www.skymedia.tv/asset/sprite) | [Github](https://github.com/RickShahid/SpriteTip) | Azure Media Player (AMP) plugin for timeline rendering of a video thumbnail image sprite that is generated from Azure Media Services (AMS) Media Encoder Standard (MES). |
2120
| Diagnostics Overlay | [Demo](https://openidconnectweb.azurewebsites.net/Diagnoverlay.html) | [Github](https://github.com/willzhan/diagnoverlay) | This plugin displays: All key parameters, stats of video, all events in the video playback lifecycle, and DRM protection info, such as key ID, license acquisition URLs, if protected. |
2221
| Frame rate and Timecode calculator | [Demo](http://mconvertitest001.blob.core.windows.net/public/example.html) | [Github](https://github.com/mconverti/media-services-javascript-azure-media-player-framerate-timecode-calculator-plugin) | This plugin calculates the frame rate of video based on the `tfhd`/`trun` MP4 boxes of the first MPEG-DASH video fragment, parses the time scale value from the MPEG-DASH client manifest, and also provides a way to generate the timecode for a given absolute time from the player (as well as provides the player absolute time given the timecode) |
23-
| <strike>Playback Speed</strike> | [Demo](https://azure-samples.github.io/media-services-javascript-Azure-Media-Player-playback-rate-plugin/) | [Github](https://github.com/Azure-Samples/media-services-javascript-azure-media-player-time-tip-plugin) | This plugin enables viewers to control what speed of the video. *Please note, this functionality is automatically available in version AMP v2.0.0+ but disabled by default.* To learn how to enable it, check out our samples [here](placeholder.md) |
22+
| <strike>Playback Speed</strike> | [Demo](https://azure-samples.github.io/media-services-javascript-Azure-Media-Player-playback-rate-plugin/) | [Github](https://github.com/Azure-Samples/media-services-javascript-azure-media-player-time-tip-plugin) | This plugin enables viewers to control what speed of the video. *Please note, this functionality is automatically available in version AMP v2.0.0+ but disabled by default.* To learn how to enable it, check out our samples [here](https://github.com/Azure-Samples/azure-media-player-samples) |
2423
| Hover Time Tip | [Demo](http://sr-test.azurewebsites.net/Tests/Plugin%20Gallery/plugins/timetip/example.html) | [Github](https://github.com/Azure-Samples/media-services-javascript-azure-media-player-time-tip-plugin) | Displays a time tip over the progress bar on mouse hover for time accurate seeking. *Please note: This plugin is already integrated into AMP* but if you're interested in seeing how it's programmed feel free to take a look. |
2524
| Title Overlay | [Demo](https://azure-samples.github.io/media-services-javascript-azure-media-player-title-overlay-plugin/") | [Github](https://github.com/Azure-Samples/media-services-javascript-azure-media-player-title-overlay-plugin) | Overlays configurable video title over screen |
2625
| Timeline Markers | [Demo](http://sr-test.azurewebsites.net/Tests/Plugin%20Gallery/plugins/timelinemarkers/example.html) | [Github](https://github.com/Azure-Samples/media-services-javascript-azure-media-player-timeline-markers-plugin) | This plugin takes in an array of times and overlays tiny markers over the progress bar at those times. |
2726
| Analytics | | | |
28-
| Application Insights | [Blog Post](https://azure.microsoft.com/en-us/blog/player-analytics-azure-media-player-plugin/) | [Github](https://github.com/Azure-Samples/media-services-javascript-azure-media-player-application-insights-plugin) | Plugin that tracks your player metrics and ports it to Power BI for an intuitive graphical representation of your viewers' player experience. |
27+
| Application Insights | [Blog Post](https://azure.microsoft.com/blog/player-analytics-azure-media-player-plugin/) | [Github](https://github.com/Azure-Samples/media-services-javascript-azure-media-player-application-insights-plugin) | Plugin that tracks your player metrics and ports it to Power BI for an intuitive graphical representation of your viewers' player experience. |
2928
| Google Analytics | N/A | [Github](https://github.com/Azure-Samples/media-services-javascript-azure-media-player-google-analytics-plugin) | Google Analytics plugin for Azure Media Player |
3029
| Diagnostics | | | |
3130
| Diagnostics Output | [Demo](http://sr-test.azurewebsites.net/Tests/Plugin%20Gallery/plugins/diagnosticslogger/example.html) | [Github](https://github.com/Azure-Samples/media-services-javascript-azure-media-player-diagnostic-logger-plugin) | This plugin outputs an array of diagnostics from your player, to see it in action go to the demo link and open up your javascript console. |
3231
| Ease of Access | | | |
3332
| Zoom In | [Demo](http://sr-test.azurewebsites.net/Tests/Plugin%20Gallery/plugins/zoom/example.html) | [Github](https://github.com/Azure-Samples/media-services-javascript-azure-media-player-zoom-plugin) | This plugin displays a drag-able zoom-in scale on the players screen so viewers can zoom in on your content |
34-
| Live Captions | [Azure Blog Post](https://azure.microsoft.com/en-us/blog/live-real-time-captions-with-azure-media-services-and-player/),[SubPly Post](http://www.subply.com/en/Products/AzureLiveCaptions.htm) | N/A | *See post for more info.* End to End workflow designed for live captioning built plugin for Azure Media Player, click on the left most lin to go to SubPly's site and learn more about the solution |
33+
| Live Captions | [Azure Blog Post](https://azure.microsoft.com/blog/live-real-time-captions-with-azure-media-services-and-player/),[SubPly Post](http://www.subply.com/en/Products/AzureLiveCaptions.htm) | N/A | *See post for more info.* End to End workflow designed for live captioning built plugin for Azure Media Player, click on the left most lin to go to SubPly's site and learn more about the solution |
3534
| Hot Keys | <strike>[Demo](http://sr-test.azurewebsites.net/Tests/Plugin%20Gallery/plugins/hotkeys/example.html)</strike> | <strike>[Github](https://github.com/Azure-Samples/media-services-javascript-azure-media-player-hot-keys-plugin)</strike> | The hot keys plugin enables viewers to control various aspects of the player with generic plugin combinations like F for fullscreen, M for mute and arrow keys for progress bar control. *Please note: This plugin has been already integrated into AMP but feel free to use it as a resource* |
3635
| Social | | | |
3736
| Share | [Demo](http://sr-test.azurewebsites.net/Tests/Plugin%20Gallery/plugins/share/example.html) | [Github](https://github.com/Azure-Samples/media-services-javascript-azure-media-player-social-share-plugin) | This plugin adds a share button to the player's control bar so that your viewers can share the video they're watching with their friends via Facebook, Twitter or Linkedin. |

articles/media-services/azure-media-player/azure-media-player-protected-content.md

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ ms.topic: overview
88
ms.date: 03/06/2020
99
---
1010

11-
### Protected Content ###
11+
# Protected Content #
1212

1313
Azure Media Player currently supports AES-128 bit envelope encrypted content and common encrypted content (through PlayReady and Widevine) or encrypted content via FairPlay. In order to playback protected content correctly, you must tell Azure Media Player the `protectionInfo`. This information exists per source and can be added directly on the `<source>` tag via the `data-setup`. You can also add the `protectionInfo` directly as a parameter if setting the source dynamically.
1414

@@ -19,9 +19,10 @@ Azure Media Player currently supports AES-128 bit envelope encrypted content and
1919

2020
- `authenticationToken`: this is an option field to add an unencoded authentication token
2121

22-
> [!IMPORTANT] The **certificateUrl** object is only needed for FairPlay DRM.***
23-
24-
>[!NOTE] The default techOrder has been changed to accommodate the new tech- `html5FairPlayHLS` specifically to playback FairPlay content natively on browsers that support it (Safari on OSX 8+). If you have FairPlay content to playback **AND** you've changed the default techOrder to a custom one in your application, you will need to add this new tech into your techOrder object. We recommend you include it before silverlightSS so your content doesn't playback via PlayReady.
22+
> [!IMPORTANT]
23+
> The **certificateUrl** object is only needed for FairPlay DRM.***
24+
>[!NOTE]
25+
> The default techOrder has been changed to accommodate the new tech- `html5FairPlayHLS` specifically to playback FairPlay content natively on browsers that support it (Safari on OSX 8+). If you have FairPlay content to playback **AND** you've changed the default techOrder to a custom one in your application, you will need to add this new tech into your techOrder object. We recommend you include it before silverlightSS so your content doesn't playback via PlayReady.
2526
2627
## Code sample ##
2728

articles/media-services/azure-media-player/azure-media-player-quickstart.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
---
2-
title:
3-
description:
2+
title: Azure Media Player Quickstart
3+
description: Learn the basic steps to set up the Azure Media Player.
44
author: IngridAtMicrosoft
55
ms.author: inhenkel
66
ms.service: media-services
7-
ms.topic: overview
7+
ms.topic: quickstart
88
ms.date: 03/13/2020
99
---
1010

0 commit comments

Comments
 (0)