DASHコンテンツ用のXMLパーサー

​

XML解析の実装

​

registerNativePlayerUtils()

global.registerNativePlayerUtils();

​

boolean isNativeXmlParserSupported(playerName: string, playerVersion: string)

#Shaka Player
if(global.isNativeXmlParserSupported("shaka", "4.6.18")) {
    console.log('プラットフォームは、このバージョンのShaka PlayerでネイティブXMLパーサーをサポートしています');
}

​

nativeParseFromString (manifest, expectedRoot)

global.nativeParseFromString(manifest, expectedRoot);

​

unloadNativeXmlParser()

global.unloadNativeXmlParser();

​

統合の変更

​

Shaka Player

• Shaka PlayerのビルドにShaka-Player-changes-for-Dash-nativization.patchが適用されていることを確認します。これにより、XML解析関数を登録するフックが有効になります。
• ネイティブ化のリリースドロップの一部として、DOMParserPolyfillというポリフィルの追加も行われています。DOMParserPolyfill.tsがアプリのポリフィルの一部として含まれていることを確認します。
• MiscPolyfill.tsファイルの更新されたリリースが、アプリのポリフィルの一部として含まれていることを確認します。このポリフィルは、基底の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 Playerの名前とバージョンがまだ定義されていない場合は定義します。
   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ポリフィルをインストールします。
    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()を呼び出して、Shaka PlayerからnativeParseFromString()の実装をネイティブXMLパーサーに渡します。setNativeFunctions()は、引数として、XMLの解析中にShaka Playerによって呼び出される関数を受け取ります。
      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のネイティブへのオフロードが有効になっていません。
                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パーサーの読み込みを解除しました');
          }
        }
        ....
      }