Improve HLS Performance

To parse the manifest call parseHlsManifest() and pass the following parameters:

• playerName: String that contains the player name "hlsjs".
• playerVersion: String that contains player version : "1.5.11"
• absoluteUri: String that contains the absolute URI of the manifest.
• manifest: ArrayBuffer that contains the downloaded manifest.
• id: Playlist Level Id. This is of number type.
• type: Playlist Level Type from imported hlsplayer lib object.
• HlsPlayerLib: Imported hlsplayer lib object from Hls.mjs.

  global.parseHlsManifest(
        playerName, playerVersion, absoluteuri, manifest, id, type, HlsPlayerLib);

The native HLS parser is supported for the 1.5.11 version of the Hls.js player. For information about using the Hls.js Player in your app with all the required patches applied, see Play adaptive content using Hls.js Player.

Note: Before building the player, make sure that the hls.js player release tarball contains the HLSJS-Nativize-HLS-manifest-parser-function.patch and that it is applied. This enables the hook to register HLS parsing function. This patch is included starting with the following tarball:

• Hls.js: hls-rel-v1.5.11-r1.4.tar.gz

setNativeFunctions Allows app to pass the implementation to call native parseHlsManifest from Hls.js Player. It accepts a function as an argument which is further called from Hls.js Player during HLS Parsing.

To use this functionality, make the following changes in your apps src/hlsjsplayer/HlsJsPlayer.ts file:

1. Define the hls.js player version in src/hlsjsplayer/HlsJsPlayer.ts:

   Copy code Copied to clipboard.

    const playerName: string = "hlsjs";
    const playerVersion: string = "1.5.11";
   

2. You can also define flag to enable or disable native parsing. As an example, the following flag is used in Step 5 to enable native parsing.

   Copy code Copied to clipboard.

    static readonly enableNativeParsing = true;
   

3. Update the required import. We rely on ./dist/hls.mjs in place of ./dist/hls.js. Update the lib object accordingly. The lines to update are identifies by '-'. Replace them with the lines identified by '+'.

   Copy code Copied to clipboard.

   ##### import update #####
   - import Hls from './dist/hls.js'; 
   + import * as HlsPlayerLib from './dist/hls.mjs'
   
   ###### lib object update #####
   
   -    this.hls = new Hls({
   +    this.hls = new HlsPlayerLib.Hls({
   

4. Add the call to parseHlsManifest().

   Copy code Copied to clipboard.

    nativeParseLevelPlaylist( manifest: string,
        absoluteuri:string,
        id: number,
        type: HlsPlayerLib.PlaylistLevelType
      ) : HlsPlayerLib.LevelDetails {
      console.log('HlsJs: nativeParseLevelPlaylist +');
      let levels: HlsPlayerLib.LevelDetails = global.parseHlsManifest(
        playerName, playerVersion, absoluteuri, manifest, id, type, HlsPlayerLib);
      console.log(`HlsJs: nativeParseLevelPlaylist -`);
      return levels;
    }
   

5. Register this function to Hls.js player before loading the player.

   Copy code Copied to clipboard.

    override async load(content: any, _autoplay: boolean): void {
      console.log("Hlsjs: Load +");
      if (HlsJsPlayer.enableNativeParsing) {
        if (global.registerNativePlayerUtils &&
          HlsPlayerLib.M3U8Parser.setNativeFunctions) {
          console.log("Hlsjs: registerNativePlayerUtils found");
          if (!global.isNativeHlsParserSupported) {
            const ret = global.registerNativePlayerUtils();
            console.log("Hlsjs: native functions registered: " + ret);
          }
          if (global.isNativeHlsParserSupported &&
              global.parseHlsManifest) {
            const nativeHlsParserSupported =
                global.isNativeHlsParserSupported(playerName, playerVersion);
            if (nativeHlsParserSupported) {
              console.log('Hlsjs: setting native functions');
              HlsPlayerLib.M3U8Parser.setNativeFunctions(this.nativeParseLevelPlaylist);
            } else {
              console.log('hlsjs: nativeHlsParser not supported for player version');
            }
          } else {
            console.log('hlsjs: native func not set even after register, skipping it');
          }
        } else {
          console.log(`hlsjs: native offload not enabled!
              registerNativePlayerUtils: ${!!global.registerNativePlayerUtils},
              setNativeFunctions: ${!!HlsPlayerLib.M3U8Parser.setNativeFunctions}`);
        }
      } else {
        console.log(`hlsjs: native playlist parsing is disabled`);
      }
   
   

These integration changes are also present in HlsjsPlayer.ts which is available as part of externalized release tarball which you can be use as a reference.