Skip to content

Commit 85ccedb

Browse files
acrolinx scores
1 parent 1713e8d commit 85ccedb

8 files changed

+66
-65
lines changed

articles/media-services/azure-media-player/azure-media-player-api-methods.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
title: Azure Media Player API Methods
3-
description: The Azure Media Player API allows you to interact with the video through JavaScript, whether the browser is playing the video through HTML5 video, Flash, Silverlight or any other supported playback technologies.
3+
description: The Azure Media Player API allows you to interact with the video through JavaScript, whether the browser is playing the video through HTML5 video, Flash, Silverlight, or any other supported playback technologies.
44
author: IngridAtMicrosoft
55
ms.author: inhenkel
66
ms.service: media-services
@@ -11,11 +11,11 @@ ms.date: 03/16/2020
1111

1212
# API #
1313

14-
The Azure Media Player API allows you to interact with the video through JavaScript, whether the browser is playing the video through HTML5 video, Flash, Silverlight or any other supported playback technologies.
14+
The Azure Media Player API allows you to interact with the video through JavaScript, whether the browser is playing the video through HTML5 video, Flash, Silverlight, or any other supported playback technologies.
1515

1616
## Referencing the player ##
1717

18-
To use the API functions, you need access to the player object. Luckily this is easy to get. You just need to make sure your video tag has an ID. The example embed code has an ID of `vid1`. If you have multiple videos on one page, make sure every video tag has a unique ID.
18+
To use the API functions, you need access to the player object. Luckily it is easy to get. You just need to make sure your video tag has an ID. The example embed code has an ID of `vid1`. If you have multiple videos on one page, make sure every video tag has a unique ID.
1919

2020
`var myPlayer = amp('vid1');`
2121

@@ -24,7 +24,7 @@ To use the API functions, you need access to the player object. Luckily this is
2424
2525
## Wait until the player is ready ##
2626

27-
The time it takes Azure Media Player to set up the video and API will vary depending on the playback technology being used (HTML5 will often be much faster to load than Flash or Silverlight). For that reason, the player's 'ready' function should be used to trigger any code that requires the player's API.
27+
The time it takes Azure Media Player to set up the video and API will vary depending on the playback technology being used. HTML5 will often be much faster to load than Flash or Silverlight. For that reason, the player's 'ready' function should be used to trigger any code that requires the player's API.
2828

2929
```javacript
3030
amp("vid_1").ready(function(){
@@ -56,7 +56,7 @@ Now that you have access to a ready player, you can control the video, get value
5656
```
5757

5858
## Registering for events ##
59-
Events should be registered for directly after initializing the player for the first time to ensure all events are appropriately reported to the application. This should be done outside of the ready event.
59+
Events should be registered directly after initializing the player for the first time to ensure all events are appropriately reported to the application, and should be done outside of the ready event.
6060

6161
```javacript
6262
var myPlayer = amp("vid_1", myOptions, function(){

articles/media-services/azure-media-player/azure-media-player-error-codes.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ ms.date: 03/13/2020
1010

1111
# Error codes #
1212

13-
When playback can not start or has stopped, an error event will be fired and `error()` function will return a code and an optional message, which is to help the app developer get more details. `error().message` is not the message displayed to the user. The message displayed to the user is based on `error().code` bits 27-20, see table below.
13+
When playback can't start or has stopped, an error event will be fired and the `error()` function will return a code and an optional message to help the app developer get more details. `error().message` isn't the message displayed to the user. The message displayed to the user is based on `error().code` bits 27-20, see table below.
1414

1515
```javascript
1616

@@ -70,15 +70,15 @@ Describe details of the error, bits 27-20 provide a high level, bits 19-0 provid
7070
| srcErrInvalidSegment | 0x0400004 | Invalid segment |
7171
| **MEDIA_ERR_ENCRYPTED errors start value(0x0500000 - 0x05FFFFF)** | | |
7272
| encryptErrUnknown | 0x0500000 | Generic encrypted error |
73-
| encryptErrDecrypterNotFound | 0x0500001 | Decryptor not found |
74-
| encryptErrDecrypterInit | 0x0500002 | Decryptor initialization error |
75-
| encryptErrDecrypterNotSupported | 0x0500003 | Decryptor not supported |
73+
| encryptErrDecrypterNotFound | 0x0500001 | Decrypter not found |
74+
| encryptErrDecrypterInit | 0x0500002 | Decrypter initialization error |
75+
| encryptErrDecrypterNotSupported | 0x0500003 | Decrypter not supported |
7676
| encryptErrKeyAcquire | 0x0500004 | Key acquire failed |
7777
| encryptErrDecryption | 0x0500005 | Decryption of segment failed |
7878
| encryptErrLicenseAcquire | 0x0500006 | License acquire failed |
7979
| **SRC_PLAYER_MISMATCH errors start value(0x0600000 - 0x06FFFFF)** | | |
8080
| srcPlayerMismatchUnknown | 0x0600000 | Generic no matching tech player to play the source |
81-
| srcPlayerMismatchFlashNotInstalled | 0x0600001 |Flash plugin is not installed, if installed the source may play. *OR* Flash 30 is installed and playing back AES content. If this is the case, please try a different browser. Flash 30 is unsupported today as of June 7th. See [known issues](azure-media-player-known-issues.md) for more details. Note: If 0x00600003, both Flash and Silverlight are not installed, if specified in the techOrder.|
81+
| srcPlayerMismatchFlashNotInstalled | 0x0600001 |Flash plugin isn't installed, if installed the source may play. *OR* Flash 30 is installed and playing back AES content. If this is the case, please try a different browser. Flash 30 is unsupported today as of June 7th. See [known issues](azure-media-player-known-issues.md) for more details. Note: If 0x00600003, both Flash and Silverlight are not installed, if specified in the techOrder.|
8282
| srcPlayerMismatchSilverlightNotInstalled | 0x0600002 | Silverlight plugin is not installed, if installed the source may play. Note: If 0x00600003, both Flash and Silverlight are not installed, if specified in the techOrder. |
8383
| | 0x00600003 | Both Flash and Silverlight are not installed, if specified in the techOrder. |
8484
| **Unknown errors (0x0FF00000)** | | |

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

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -16,17 +16,17 @@ The current release has the following known issues:
1616

1717
- Incorrectly configured encoders may cause issues with playback
1818
- Streams with timestamps greater than 2^53 may have playback issues.
19-
- Mitigation: Use 90 kHz video and 44.1 kHz audio timescales
20-
- No autoplay on mobile devices without user interaction. This is blocked by the platform.
19+
- Mitigation: Use 90-kHz video and 44.1-kHz audio timescales
20+
- No autoplay on mobile devices without user interaction. It's blocked by the platform.
2121
- Seeking near discontinuities may cause playback failure.
2222
- Download of large presentations may cause UI to lockup.
23-
- Cannot automatically playback same source again after presentation ended.
24-
- To replay a source after it has ended, it is required to set the source again.
23+
- Can't automatically play back same source again after presentation ended.
24+
- To replay a source after it has ended, it's required to set the source again.
2525
- Empty manifests may cause issues with the player.
2626
- This issue can occur when starting a live stream and not enough chunks are found in the manifest.
2727
- Playback position maybe outside UI seekbar.
28-
- Event ordering is not consistent across all techs.
29-
- Buffered property is not consistent across techs.
28+
- Event ordering isn't consistent across all techs.
29+
- Buffered property isn't consistent across techs.
3030
- nativeControlsForTouch must be false (default) to avoid "Object doesn't support property or method 'setControls'"
3131
- Posters must now be absolute urls
3232
- Minor aesthetic issues may occur in the UI when using high contrast mode of the device
@@ -39,26 +39,26 @@ The current release has the following known issues:
3939

4040
## AzureHtml5JS ##
4141

42-
- 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.
42+
- In the DVR window of Live content, when content finishes the timeline will continue to grow until seeking to the area or reaching the end of the presentation.
4343
- Live presentations in Firefox with MSE enabled has some issues
44-
- Assets that are audio or video only will not play back via the AzureHtml5JS tech.
44+
- Assets that are audio or video only won't play back via the AzureHtml5JS tech.
4545
- 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)
4646
- 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

50-
- AES content does not playback in Flash version 30.0.0.134 due to a bug in Adobe's caching logic. Adobe has fixed the issue and released it in 30.0.0.154
50+
- AES content does not play back in Flash version 30.0.0.134 due to a bug in Adobe's caching logic. Adobe has fixed the issue and released it in 30.0.0.154
5151
- Tech and http failures (such as 404 network timeouts), the player will take longer to recover than other techs.
52-
- Click on video area with flashSS tech will not play/pause the player.
53-
- Infinite spinner can occur when player is stuck in the case where end user has Flash installed but does not give permission to load on the site. Player thinks plugin is available (as it is installed) and thinks plugin is running the content as JavaScript code has been sent but the browser settings have blocked plugin from executing until user accepts prompt to allow plugin. This can occur in all browsers.
52+
- Click on video area with flashSS tech won't play/pause the player.
53+
- If the user has Flash installed but doesn't give permission to load it on the site, infinite spinning can occur. This is because the player thinks the plugin is installed and available and it thinks the plugin is running the content. JavaScript code has been sent but the browser settings have blocked the plugin from executing until the user accepts the prompt to allow the plugin. This can occur in all browsers.
5454

5555
## Silverlight ##
5656

5757
- Missing features
5858
- Tech and http failures (such as 404 network timeouts), the player will take longer to recover than other techs.
5959
- Safari and Firefox on Mac playback with Silverlight requires explicitly defining `"http://` or `https://` for the source.
6060
- If an API is missing for this tech, it will generally return null.
61-
- Infinite spinner can occur when player is stuck in the case where end user has Silverlight installed but does not give permission to load on the site. Player thinks plugin is available (as it is installed) and thinks plugin is running the content as JavaScript code has been sent but the browser settings have blocked plugin from executing until user accepts prompt to allow plugin. This can occur in all browsers.
61+
- If the user has Flash installed but doesn't give permission to load it on the site, infinite spinning can occur. This is because the player thinks the plugin is installed and available and it thinks the plugin is running the content. JavaScript code has been sent but the browser settings have blocked the plugin from executing until the user accepts the prompt to allow the plugin. This can occur in all browsers.
6262

6363
## Native HTML5 ##
6464

@@ -76,7 +76,7 @@ The current release has the following known issues:
7676
## Google ##
7777

7878
- Multiple encoding profiles in the same manifest has some playback issues in Chrome and is not recommended.
79-
- Chrome cannot playback HE-AAC with AzureHtml5JS. Follow details on the [bug tracker](https://bugs.chromium.org/p/chromium/issues/detail?id=534301).
79+
- Chrome cannot play back HE-AAC with AzureHtml5JS. Follow details on the [bug tracker](https://bugs.chromium.org/p/chromium/issues/detail?id=534301).
8080
- As of Chrome v58, widevine content must be loaded/played back via the https:// protocol otherwise playback will fail.
8181

8282
## Mozilla ##
@@ -85,11 +85,11 @@ The current release has the following known issues:
8585

8686
## Apple ##
8787

88-
- Safari on Mac often enables Power Saver mode by default with the setting "Stop plug-ins to save power", which blocks plugins like Flash and Silverlight when they believe it is not in favor to the user. This block does not block the plugin's existent, only capabilities. Given the default techOrder, this may cause issues when attempting to playback
88+
- Safari on Mac often enables Power Saver mode by default with the setting "Stop plug-ins to save power", which blocks plugins like Flash and Silverlight when they believe it is not in favor to the user. This block does not block the plugin's existent, only capabilities. Given the default techOrder, this may cause issues when attempting to play back
8989
- Mitigation 1: If the video player is 'front and center' (within a 3000 x 3000 pixel boundary starting at the top left corner of the document) it should still play.
9090
- Mitigation 2: Change the techOrder for Safari to be ["azureHtml5JS", "html5"]. This mitigation has implication of not getting all the features that are available in the FlashSS tech.
9191
- PlayReady content via Silverlight may have issues playing back in Safari.
92-
- AES and restricted token content does not playback using iOS and older Android devices.
92+
- AES and restricted token content does not play back using iOS and older Android devices.
9393
- In order to achieve this scenario, a proxy must be added to your service.
9494
- Default skin for iOS Phone shows through.
9595
- iPhone playback always occurs in the native player fullscreen.
@@ -101,7 +101,7 @@ The current release has the following known issues:
101101

102102
## Older Android ##
103103

104-
- AES and restricted token content does not playback using iOS and older Android devices.
104+
- AES and restricted token content does not play back using iOS and older Android devices.
105105
- In order to achieve this scenario, a proxy must be added to your service.
106106

107107
## Next steps ##

0 commit comments

Comments
 (0)