用于DASH内容的XML解析器

​

实现XML解析

​

registerNativePlayerUtils()

global.registerNativePlayerUtils();

​

boolean isNativeXmlParserSupported(playerName: string, playerVersion: string)

# Shaka播放器
if(global.isNativeXmlParserSupported("shaka", "4.6.18")) {
    console.log('平台支持此版本Shaka播放器的原生Xml解析器');
}

​

nativeParseFromString (manifest, expectedRoot)

global.nativeParseFromString(manifest, expectedRoot);

​

unloadNativeXmlParser()

global.unloadNativeXmlParser();

​

集成变更

​

Shaka播放器

• 确保Shaka播放器构建版本中有Shaka-Player-changes-for-Dash-nativization.patch，其让挂钩能够注册XML解析函数。
• 作为原生化版本发布的一部分，我们还添加了一个polyfill：DOMParserPolyfill。确保选择DOMParserPolyfill.ts作为应用polyfill的组成部分。
• 确保选择MiscPolyfill.ts文件的最新版本作为应用polyfill的组成部分。此polyfill进行了更新，以消除对基本DomParser对象的依赖。

• ShakaPlayer v4.6.18：shaka-rel-v4.6.18-r2.11.tar.gz
• ShakaPlayer v4.3.6：shaka-rel-v4.3.6-r2.4.tar.gz

1. 如果尚未定义，请在src/shakaplayer/ShakaPlayer.ts中定义Shaka播放器的名称和版本：
   const playerName: string = "shaka";
   const playerVersion: string = "4.6.18";
   
2. 或者，您可以定义一个标记来启用和禁用原生XML解析。例如，在步骤5中使用了以下标记来启用原生解析。
   static readonly enableNativeXmlParsing = true;
   
3. 导入并安装DOMParserPolyfill。
    import DOMParserPolyfill from '../polyfills/DOMParserPolyfill';
   
    // 安装DOMParser polyfill
    DOMParserPolyfill.install();
   
4. 调用nativeParseFromString()。
        nativeParseFromString(manifest: ArrayBuffer, expectedRoot: string)
            :Array<shaka.hls.Playlist> {
          console.log('shaka: nativeParseFromString+');
          console.log('shaka：nativeParseFromString：expectedRoot ', expectedRoot);
          const playlist = global.nativeParseFromString(manifest, expectedRoot);
          console.log('shaka: nativeParseFromString-');
          return playlist;
        }
   
5. 在您的ShakaPlayer.ts文件中添加一个load() 函数，以验证所需的功能是否可用于原生XML解析。完成功能验证后，它会调用setNativeFunctions()，从而通过调用nativeParseFromString() 将实现从Shaka播放器传递给原生XML解析器。setNativeFunctions() 接受一个函数作为参数，Shaka播放器会在XML解析期间调用该函数。
   load(content: any, autoplay: boolean): void {
     ....
     // 在load() 中添加以下代码片段
     if (ShakaPlayer.enableNativeXmlParsing) {
       // 适用于Dash内容
       if (global.registerNativePlayerUtils &&
         shaka.util.XmlUtils.setNativeFunctions) {
         if (!global.isNativeXmlParserSupported) {
           console.log("shaka：isNativeXmlParserSupported未注册。");
         }
         if (global.isNativeXmlParserSupported &&
             global.nativeParseFromString) {
           const isNativeXmlParserSupported =
               global.isNativeXmlParserSupported(playerName, playerVersion);
           if (isNativeXmlParserSupported) {
             console.log('shaka：设置DASH原生函数');
             shaka.util.XmlUtils.setNativeFunctions(this.nativeParseFromString);
           } else {
             console.log('shaka：nativeXMLParser不受支持的播放器版本');
           }
         } else {
           console.log('shaka：即使注册后也未设置本机函数，跳过它');
         }
       } else { console.log(`shakaplayer: DASH native offload not enabled!
             registerNativePlayerUtils: ${!!global.registerNativePlayerUtils},
             DASH::setNativeFunctions: ${!!shaka.util.XmlUtils.setNativeFunctions}`);
       }
     } else {
       console.log(`shaka：原生Xml播放列表解析已禁用`);
     }
     ....
   }
   
6. 在ShakaPlayer.ts文件中添加一个unload() 函数来检查是否启用了原生XML解析。如果是，请调用unloadNativeXmlParser来卸载解析器。
   unload() : void {
     ....
     // 在unload() 中添加以下代码片段
     if (ShakaPlayer.enableNativeXmlParsing && global.isNativeXmlParserSupported &&
       global.nativeParseFromString && global.unloadNativeXmlParser) {
       const isNativeXmlParserSupported =
         global.isNativeXmlParserSupported(playerName, playerVersion);
       if (isNativeXmlParserSupported) {
         console.log('shakaplayer：正在卸载原生Xml解析器');
         global.unloadNativeXmlParser();
         console.log('shakaplayer：已卸载原生Xml解析器');
       }
     }
     ....
   }