documentation adjustements

README.md

@@ -171,9 +171,9 @@ NOTES:
 |HLS       |**Y**     |**Y**    |**Y** ¹  | -        |
 
 NOTES:
- - ¹: We support FairPlay through MSE/EME when available and when
-   `useNativeHlsOnSafari` is turned off. Otherwise, we are using
-   Apple's native HLS player.
+ - ¹: By default, FairPlay is handled using Apple's native HLS player, when on
+   Safari. We do support FairPlay through MSE/EME, however. See the
+   `streaming.useNativeHlsOnSafari` configuration value.
 
 
 ## Media container and subtitle support

docs/tutorials/fairplay.md

@@ -24,7 +24,7 @@ player.configure('drm.advanced.com\\.apple\\.fps\\.serverCertificateUri',
 
 ## Content ID
 
-Note: This is specific when legacy Apple Media Keys is used.
+Note: This only applies when legacy Apple Media Keys is used.
 
 Some FairPlay content use custom signaling for the content ID.  The content ID
 is used by the browser to generate the license request.  If you don't use the

externs/shaka/player.js

@@ -928,6 +928,9 @@ shaka.extern.ManifestConfiguration;
  * @property {boolean} useNativeHlsOnSafari
  *   Desktop Safari has both MediaSource and their native HLS implementation.
  *   Depending on the application's needs, it may prefer one over the other.
+ *   Warning: Where single-key HLS Fairplay streams work fine, multi-keys
+ *   streams is showing unexpected behaviours (stall, audio playing with video
+ *   freezes, ...). Use with care.
  * @property {number} inaccurateManifestTolerance
  *   The maximum difference, in seconds, between the times in the manifest and
  *   the times in the segments.  Larger values allow us to compensate for more