@xrift/world-components 0.21.12 → 0.22.0

package/dist/components/LiveVideoPlayer/hooks/useHlsVideo/classes/RecoveryTracker.js

@@ -0,0 +1,54 @@
+/** リカバリのスロットリング間隔（ms） */
+const RECOVERY_THROTTLE_MS = 5000;
+/** リカバリ失敗とみなすまでの最大試行回数 */
+const MAX_RECOVERY_ATTEMPTS = 3;
+/**
+ * エラーリカバリの試行を追跡するクラス
+ * スロットリングと試行回数制限を管理
+ */
+export class RecoveryTracker {
+    constructor() {
+        this.lastRecoveryTime = 0;
+        this.recoveryAttempts = 0;
+        this.errorReported = false;
+    }
+    /** 状態をリセット */
+    reset() {
+        this.lastRecoveryTime = 0;
+        this.recoveryAttempts = 0;
+        this.errorReported = false;
+    }
+    /** エラーが既に報告済みかどうか */
+    get isErrorReported() {
+        return this.errorReported;
+    }
+    /** エラーを報告済みとしてマーク */
+    markErrorReported() {
+        this.errorReported = true;
+    }
+    /**
+     * リカバリを試行可能かどうかを判定し、カウンターを更新
+     * @returns リカバリを試行すべきかどうか
+     */
+    shouldAttemptRecovery() {
+        const now = Date.now();
+        const timeSinceLastRecovery = now - this.lastRecoveryTime;
+        // スロットリング: 5秒以内の連続エラーはカウント増加
+        if (timeSinceLastRecovery < RECOVERY_THROTTLE_MS) {
+            this.recoveryAttempts++;
+        }
+        else {
+            // 5秒以上経過していればカウントリセット
+            this.recoveryAttempts = 1;
+        }
+        this.lastRecoveryTime = now;
+        // 最大試行回数を超えた場合はリカバリ失敗
+        if (this.recoveryAttempts > MAX_RECOVERY_ATTEMPTS) {
+            console.error(`[RecoveryTracker] Recovery failed after ${MAX_RECOVERY_ATTEMPTS} attempts`);
+            return false;
+        }
+        console.log(`[RecoveryTracker] Attempting recovery (attempt ${this.recoveryAttempts}/${MAX_RECOVERY_ATTEMPTS})`);
+        return true;
+    }
+}
+//# sourceMappingURL=RecoveryTracker.js.map

package/dist/components/LiveVideoPlayer/hooks/useHlsVideo/classes/RecoveryTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecoveryTracker.js","sourceRoot":"","sources":["../../../../../../src/components/LiveVideoPlayer/hooks/useHlsVideo/classes/RecoveryTracker.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,MAAM,oBAAoB,GAAG,IAAI,CAAA;AACjC,0BAA0B;AAC1B,MAAM,qBAAqB,GAAG,CAAC,CAAA;AAE/B;;;GAGG;AACH,MAAM,OAAO,eAAe;IAA5B;QACU,qBAAgB,GAAG,CAAC,CAAA;QACpB,qBAAgB,GAAG,CAAC,CAAA;QACpB,kBAAa,GAAG,KAAK,CAAA;IAkD/B,CAAC;IAhDC,cAAc;IACd,KAAK;QACH,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAA;QACzB,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAA;QACzB,IAAI,CAAC,aAAa,GAAG,KAAK,CAAA;IAC5B,CAAC;IAED,qBAAqB;IACrB,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,aAAa,CAAA;IAC3B,CAAC;IAED,qBAAqB;IACrB,iBAAiB;QACf,IAAI,CAAC,aAAa,GAAG,IAAI,CAAA;IAC3B,CAAC;IAED;;;OAGG;IACH,qBAAqB;QACnB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACtB,MAAM,qBAAqB,GAAG,GAAG,GAAG,IAAI,CAAC,gBAAgB,CAAA;QAEzD,6BAA6B;QAC7B,IAAI,qBAAqB,GAAG,oBAAoB,EAAE,CAAC;YACjD,IAAI,CAAC,gBAAgB,EAAE,CAAA;QACzB,CAAC;aAAM,CAAC;YACN,sBAAsB;YACtB,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAA;QAC3B,CAAC;QAED,IAAI,CAAC,gBAAgB,GAAG,GAAG,CAAA;QAE3B,sBAAsB;QACtB,IAAI,IAAI,CAAC,gBAAgB,GAAG,qBAAqB,EAAE,CAAC;YAClD,OAAO,CAAC,KAAK,CACX,2CAA2C,qBAAqB,WAAW,CAC5E,CAAA;YACD,OAAO,KAAK,CAAA;QACd,CAAC;QAED,OAAO,CAAC,GAAG,CACT,kDAAkD,IAAI,CAAC,gBAAgB,IAAI,qBAAqB,GAAG,CACpG,CAAA;QACD,OAAO,IAAI,CAAA;IACb,CAAC;CACF"}

package/dist/components/LiveVideoPlayer/hooks/useHlsVideo/classes/__tests__/HlsJsPlayer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=HlsJsPlayer.test.d.ts.map

package/dist/components/LiveVideoPlayer/hooks/useHlsVideo/classes/__tests__/HlsJsPlayer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HlsJsPlayer.test.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/LiveVideoPlayer/hooks/useHlsVideo/classes/__tests__/HlsJsPlayer.test.ts"],"names":[],"mappings":""}

package/dist/components/LiveVideoPlayer/hooks/useHlsVideo/classes/__tests__/HlsJsPlayer.test.js

@@ -0,0 +1,146 @@
+/**
+ * @vitest-environment jsdom
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { HlsJsPlayer } from '../HlsJsPlayer';
+import { RecoveryTracker } from '../RecoveryTracker';
+// hls.js のモック
+function createMockHls() {
+    const eventHandlers = {};
+    const mockHlsInstance = {
+        on: vi.fn((event, handler) => {
+            eventHandlers[event] = handler;
+        }),
+        loadSource: vi.fn(),
+        attachMedia: vi.fn(),
+        destroy: vi.fn(),
+        recoverMediaError: vi.fn(),
+        startLoad: vi.fn(),
+        // イベントをトリガーするヘルパー
+        _trigger: (event, ...args) => {
+            eventHandlers[event]?.(...args);
+        },
+    };
+    // コンストラクタ関数として使えるクラスを作成
+    class MockHlsClass {
+        constructor(_config) {
+            this.on = mockHlsInstance.on;
+            this.loadSource = mockHlsInstance.loadSource;
+            this.attachMedia = mockHlsInstance.attachMedia;
+            this.destroy = mockHlsInstance.destroy;
+            this.recoverMediaError = mockHlsInstance.recoverMediaError;
+            this.startLoad = mockHlsInstance.startLoad;
+            // コンストラクタの引数は無視
+        }
+    }
+    MockHlsClass.Events = {
+        ERROR: 'hlsError',
+        FRAG_BUFFERED: 'hlsFragBuffered',
+        MANIFEST_PARSED: 'hlsManifestParsed',
+    };
+    MockHlsClass.ErrorTypes = {
+        MEDIA_ERROR: 'mediaError',
+        NETWORK_ERROR: 'networkError',
+        OTHER_ERROR: 'otherError',
+    };
+    return { MockHlsClass: MockHlsClass, mockHlsInstance };
+}
+describe('HlsJsPlayer', () => {
+    let video;
+    let tracker;
+    beforeEach(() => {
+        video = document.createElement('video');
+        tracker = new RecoveryTracker();
+    });
+    it('初期化時に attachMedia が呼ばれる', () => {
+        const { MockHlsClass, mockHlsInstance } = createMockHls();
+        new HlsJsPlayer(MockHlsClass, {
+            video,
+            tracker,
+            callbacks: {},
+        });
+        expect(mockHlsInstance.attachMedia).toHaveBeenCalledWith(video);
+    });
+    it('load で loadSource が呼ばれる', () => {
+        const { MockHlsClass, mockHlsInstance } = createMockHls();
+        const player = new HlsJsPlayer(MockHlsClass, {
+            video,
+            tracker,
+            callbacks: {},
+        });
+        player.load('https://example.com/video.m3u8');
+        expect(mockHlsInstance.loadSource).toHaveBeenCalledWith('https://example.com/video.m3u8');
+    });
+    it('destroy で hls.destroy が呼ばれる', () => {
+        const { MockHlsClass, mockHlsInstance } = createMockHls();
+        const player = new HlsJsPlayer(MockHlsClass, {
+            video,
+            tracker,
+            callbacks: {},
+        });
+        player.destroy();
+        expect(mockHlsInstance.destroy).toHaveBeenCalled();
+    });
+    it('MANIFEST_PARSED イベントで onManifestParsed コールバックが呼ばれる', () => {
+        const { MockHlsClass, mockHlsInstance } = createMockHls();
+        const onManifestParsed = vi.fn();
+        new HlsJsPlayer(MockHlsClass, {
+            video,
+            tracker,
+            callbacks: { onManifestParsed },
+        });
+        mockHlsInstance._trigger('hlsManifestParsed');
+        expect(onManifestParsed).toHaveBeenCalled();
+    });
+    it('FRAG_BUFFERED イベントで onBufferingChange(false) が呼ばれる', () => {
+        const { MockHlsClass, mockHlsInstance } = createMockHls();
+        const onBufferingChange = vi.fn();
+        new HlsJsPlayer(MockHlsClass, {
+            video,
+            tracker,
+            callbacks: { onBufferingChange },
+        });
+        mockHlsInstance._trigger('hlsFragBuffered');
+        expect(onBufferingChange).toHaveBeenCalledWith(false);
+    });
+    it('非致命的エラーは無視される', () => {
+        const { MockHlsClass, mockHlsInstance } = createMockHls();
+        const onError = vi.fn();
+        new HlsJsPlayer(MockHlsClass, {
+            video,
+            tracker,
+            callbacks: { onError },
+        });
+        mockHlsInstance._trigger('hlsError', {}, { fatal: false, details: 'someError' });
+        expect(onError).not.toHaveBeenCalled();
+    });
+    it('MEDIA_ERROR 時に recoverMediaError が呼ばれる', () => {
+        const { MockHlsClass, mockHlsInstance } = createMockHls();
+        new HlsJsPlayer(MockHlsClass, {
+            video,
+            tracker,
+            callbacks: {},
+        });
+        mockHlsInstance._trigger('hlsError', {}, {
+            fatal: true,
+            type: 'mediaError',
+            details: 'bufferStalledError',
+        });
+        expect(mockHlsInstance.recoverMediaError).toHaveBeenCalled();
+    });
+    it('NETWORK_ERROR 時に startLoad が呼ばれる', () => {
+        const { MockHlsClass, mockHlsInstance } = createMockHls();
+        new HlsJsPlayer(MockHlsClass, {
+            video,
+            tracker,
+            callbacks: {},
+        });
+        mockHlsInstance._trigger('hlsError', {}, {
+            fatal: true,
+            type: 'networkError',
+            details: 'networkError',
+        });
+        expect(mockHlsInstance.startLoad).toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=HlsJsPlayer.test.js.map

package/dist/components/LiveVideoPlayer/hooks/useHlsVideo/classes/__tests__/HlsJsPlayer.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HlsJsPlayer.test.js","sourceRoot":"","sources":["../../../../../../../src/components/LiveVideoPlayer/hooks/useHlsVideo/classes/__tests__/HlsJsPlayer.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEpD,cAAc;AACd,SAAS,aAAa;IACpB,MAAM,aAAa,GAA6B,EAAE,CAAA;IAElD,MAAM,eAAe,GAAG;QACtB,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,KAAa,EAAE,OAAiB,EAAE,EAAE;YAC7C,aAAa,CAAC,KAAK,CAAC,GAAG,OAAO,CAAA;QAChC,CAAC,CAAC;QACF,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE;QACnB,WAAW,EAAE,EAAE,CAAC,EAAE,EAAE;QACpB,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE;QAChB,iBAAiB,EAAE,EAAE,CAAC,EAAE,EAAE;QAC1B,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE;QAClB,kBAAkB;QAClB,QAAQ,EAAE,CAAC,KAAa,EAAE,GAAG,IAAe,EAAE,EAAE;YAC9C,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAA;QACjC,CAAC;KACF,CAAA;IAED,wBAAwB;IACxB,MAAM,YAAY;QAQhB,YAAY,OAAgB;YAP5B,OAAE,GAAG,eAAe,CAAC,EAAE,CAAA;YACvB,eAAU,GAAG,eAAe,CAAC,UAAU,CAAA;YACvC,gBAAW,GAAG,eAAe,CAAC,WAAW,CAAA;YACzC,YAAO,GAAG,eAAe,CAAC,OAAO,CAAA;YACjC,sBAAiB,GAAG,eAAe,CAAC,iBAAiB,CAAA;YACrD,cAAS,GAAG,eAAe,CAAC,SAAS,CAAA;YAGnC,gBAAgB;QAClB,CAAC;;IAEM,mBAAM,GAAG;QACd,KAAK,EAAE,UAAU;QACjB,aAAa,EAAE,iBAAiB;QAChC,eAAe,EAAE,mBAAmB;KACrC,AAJY,CAIZ;IAEM,uBAAU,GAAG;QAClB,WAAW,EAAE,YAAY;QACzB,aAAa,EAAE,cAAc;QAC7B,WAAW,EAAE,YAAY;KAC1B,AAJgB,CAIhB;IAGH,OAAO,EAAE,YAAY,EAAE,YAA0D,EAAE,eAAe,EAAE,CAAA;AACtG,CAAC;AAED,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,IAAI,KAAuB,CAAA;IAC3B,IAAI,OAAwB,CAAA;IAE5B,UAAU,CAAC,GAAG,EAAE;QACd,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAA;QACvC,OAAO,GAAG,IAAI,eAAe,EAAE,CAAA;IACjC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,GAAG,aAAa,EAAE,CAAA;QAEzD,IAAI,WAAW,CAAC,YAAY,EAAE;YAC5B,KAAK;YACL,OAAO;YACP,SAAS,EAAE,EAAE;SACd,CAAC,CAAA;QAEF,MAAM,CAAC,eAAe,CAAC,WAAW,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAA;IACjE,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,GAAG,aAAa,EAAE,CAAA;QAEzD,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,YAAY,EAAE;YAC3C,KAAK;YACL,OAAO;YACP,SAAS,EAAE,EAAE;SACd,CAAC,CAAA;QAEF,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAA;QAC7C,MAAM,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC,oBAAoB,CAAC,gCAAgC,CAAC,CAAA;IAC3F,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,GAAG,aAAa,EAAE,CAAA;QAEzD,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,YAAY,EAAE;YAC3C,KAAK;YACL,OAAO;YACP,SAAS,EAAE,EAAE;SACd,CAAC,CAAA;QAEF,MAAM,CAAC,OAAO,EAAE,CAAA;QAChB,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,gBAAgB,EAAE,CAAA;IACpD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,GAAG,aAAa,EAAE,CAAA;QACzD,MAAM,gBAAgB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;QAEhC,IAAI,WAAW,CAAC,YAAY,EAAE;YAC5B,KAAK;YACL,OAAO;YACP,SAAS,EAAE,EAAE,gBAAgB,EAAE;SAChC,CAAC,CAAA;QAEF,eAAe,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAA;QAC7C,MAAM,CAAC,gBAAgB,CAAC,CAAC,gBAAgB,EAAE,CAAA;IAC7C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,GAAG,aAAa,EAAE,CAAA;QACzD,MAAM,iBAAiB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;QAEjC,IAAI,WAAW,CAAC,YAAY,EAAE;YAC5B,KAAK;YACL,OAAO;YACP,SAAS,EAAE,EAAE,iBAAiB,EAAE;SACjC,CAAC,CAAA;QAEF,eAAe,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAA;QAC3C,MAAM,CAAC,iBAAiB,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAA;IACvD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,eAAe,EAAE,GAAG,EAAE;QACvB,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,GAAG,aAAa,EAAE,CAAA;QACzD,MAAM,OAAO,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;QAEvB,IAAI,WAAW,CAAC,YAAY,EAAE;YAC5B,KAAK;YACL,OAAO;YACP,SAAS,EAAE,EAAE,OAAO,EAAE;SACvB,CAAC,CAAA;QAEF,eAAe,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAA;QAChF,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAA;IACxC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,GAAG,aAAa,EAAE,CAAA;QAEzD,IAAI,WAAW,CAAC,YAAY,EAAE;YAC5B,KAAK;YACL,OAAO;YACP,SAAS,EAAE,EAAE;SACd,CAAC,CAAA;QAEF,eAAe,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,EAAE;YACvC,KAAK,EAAE,IAAI;YACX,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,oBAAoB;SAC9B,CAAC,CAAA;QAEF,MAAM,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC,gBAAgB,EAAE,CAAA;IAC9D,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,GAAG,aAAa,EAAE,CAAA;QAEzD,IAAI,WAAW,CAAC,YAAY,EAAE;YAC5B,KAAK;YACL,OAAO;YACP,SAAS,EAAE,EAAE;SACd,CAAC,CAAA;QAEF,eAAe,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,EAAE;YACvC,KAAK,EAAE,IAAI;YACX,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,cAAc;SACxB,CAAC,CAAA;QAEF,MAAM,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,gBAAgB,EAAE,CAAA;IACtD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/components/LiveVideoPlayer/hooks/useHlsVideo/classes/__tests__/NativeHlsPlayer.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=NativeHlsPlayer.test.d.ts.map

package/dist/components/LiveVideoPlayer/hooks/useHlsVideo/classes/__tests__/NativeHlsPlayer.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeHlsPlayer.test.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/LiveVideoPlayer/hooks/useHlsVideo/classes/__tests__/NativeHlsPlayer.test.ts"],"names":[],"mappings":""}

package/dist/components/LiveVideoPlayer/hooks/useHlsVideo/classes/__tests__/NativeHlsPlayer.test.js

@@ -0,0 +1,94 @@
+/**
+ * @vitest-environment jsdom
+ */
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { NativeHlsPlayer } from '../NativeHlsPlayer';
+import { RecoveryTracker } from '../RecoveryTracker';
+// MediaError 定数（jsdom にないため定義）
+const MEDIA_ERR_DECODE = 3;
+const MEDIA_ERR_NETWORK = 2;
+describe('NativeHlsPlayer', () => {
+    let video;
+    let tracker;
+    beforeEach(() => {
+        video = document.createElement('video');
+        tracker = new RecoveryTracker();
+    });
+    it('load で video.src が設定される', () => {
+        const player = new NativeHlsPlayer({
+            video,
+            tracker,
+            callbacks: {},
+        });
+        player.load('https://example.com/video.m3u8');
+        expect(video.src).toContain('video.m3u8');
+    });
+    it('destroy でエラーイベントリスナーが削除される', () => {
+        const removeEventListenerSpy = vi.spyOn(video, 'removeEventListener');
+        const player = new NativeHlsPlayer({
+            video,
+            tracker,
+            callbacks: {},
+        });
+        player.destroy();
+        expect(removeEventListenerSpy).toHaveBeenCalledWith('error', expect.any(Function));
+    });
+    it('デコードエラー時に currentTime をスキップしてリカバリを試みる', () => {
+        const playSpy = vi.spyOn(video, 'play').mockResolvedValue();
+        new NativeHlsPlayer({
+            video,
+            tracker,
+            callbacks: {},
+        });
+        // video.currentTime を設定
+        Object.defineProperty(video, 'currentTime', {
+            value: 10,
+            writable: true,
+        });
+        // MEDIA_ERR_DECODE エラーをシミュレート
+        Object.defineProperty(video, 'error', {
+            value: { code: MEDIA_ERR_DECODE, message: 'Decode error' },
+        });
+        // エラーイベントを発火
+        video.dispatchEvent(new Event('error'));
+        // currentTime が 0.5 秒進んでいることを確認
+        expect(video.currentTime).toBe(10.5);
+        expect(playSpy).toHaveBeenCalled();
+    });
+    it('リカバリ上限を超えると onError が呼ばれる', () => {
+        const onError = vi.fn();
+        new NativeHlsPlayer({
+            video,
+            tracker,
+            callbacks: { onError },
+        });
+        // MEDIA_ERR_DECODE エラーを設定
+        Object.defineProperty(video, 'error', {
+            value: { code: MEDIA_ERR_DECODE, message: 'Decode error' },
+        });
+        // リカバリ試行を消費
+        tracker.shouldAttemptRecovery(); // 1
+        tracker.shouldAttemptRecovery(); // 2
+        tracker.shouldAttemptRecovery(); // 3
+        tracker.shouldAttemptRecovery(); // 4 - 失敗
+        // エラーイベントを発火
+        video.dispatchEvent(new Event('error'));
+        expect(onError).toHaveBeenCalledWith(expect.any(Error));
+    });
+    it('デコードエラー以外はすぐに onError が呼ばれる', () => {
+        const onError = vi.fn();
+        new NativeHlsPlayer({
+            video,
+            tracker,
+            callbacks: { onError },
+        });
+        // MEDIA_ERR_NETWORK エラーを設定
+        Object.defineProperty(video, 'error', {
+            value: { code: MEDIA_ERR_NETWORK, message: 'Network error' },
+        });
+        // エラーイベントを発火
+        video.dispatchEvent(new Event('error'));
+        expect(onError).toHaveBeenCalledWith(expect.any(Error));
+    });
+});
+//# sourceMappingURL=NativeHlsPlayer.test.js.map

package/dist/components/LiveVideoPlayer/hooks/useHlsVideo/classes/__tests__/NativeHlsPlayer.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeHlsPlayer.test.js","sourceRoot":"","sources":["../../../../../../../src/components/LiveVideoPlayer/hooks/useHlsVideo/classes/__tests__/NativeHlsPlayer.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAEpD,+BAA+B;AAC/B,MAAM,gBAAgB,GAAG,CAAC,CAAA;AAC1B,MAAM,iBAAiB,GAAG,CAAC,CAAA;AAE3B,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,IAAI,KAAuB,CAAA;IAC3B,IAAI,OAAwB,CAAA;IAE5B,UAAU,CAAC,GAAG,EAAE;QACd,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC,OAAO,CAAC,CAAA;QACvC,OAAO,GAAG,IAAI,eAAe,EAAE,CAAA;IACjC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;YACjC,KAAK;YACL,OAAO;YACP,SAAS,EAAE,EAAE;SACd,CAAC,CAAA;QAEF,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAA;QAC7C,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC,CAAA;IAC3C,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QACpC,MAAM,sBAAsB,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,qBAAqB,CAAC,CAAA;QAErE,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;YACjC,KAAK;YACL,OAAO;YACP,SAAS,EAAE,EAAE;SACd,CAAC,CAAA;QAEF,MAAM,CAAC,OAAO,EAAE,CAAA;QAChB,MAAM,CAAC,sBAAsB,CAAC,CAAC,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAA;IACpF,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,iBAAiB,EAAE,CAAA;QAE3D,IAAI,eAAe,CAAC;YAClB,KAAK;YACL,OAAO;YACP,SAAS,EAAE,EAAE;SACd,CAAC,CAAA;QAEF,wBAAwB;QACxB,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE;YAC1C,KAAK,EAAE,EAAE;YACT,QAAQ,EAAE,IAAI;SACf,CAAC,CAAA;QAEF,8BAA8B;QAC9B,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE;YACpC,KAAK,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,cAAc,EAAE;SAC3D,CAAC,CAAA;QAEF,aAAa;QACb,KAAK,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAA;QAEvC,gCAAgC;QAChC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACpC,MAAM,CAAC,OAAO,CAAC,CAAC,gBAAgB,EAAE,CAAA;IACpC,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACnC,MAAM,OAAO,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;QAEvB,IAAI,eAAe,CAAC;YAClB,KAAK;YACL,OAAO;YACP,SAAS,EAAE,EAAE,OAAO,EAAE;SACvB,CAAC,CAAA;QAEF,0BAA0B;QAC1B,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE;YACpC,KAAK,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,cAAc,EAAE;SAC3D,CAAC,CAAA;QAEF,YAAY;QACZ,OAAO,CAAC,qBAAqB,EAAE,CAAA,CAAC,IAAI;QACpC,OAAO,CAAC,qBAAqB,EAAE,CAAA,CAAC,IAAI;QACpC,OAAO,CAAC,qBAAqB,EAAE,CAAA,CAAC,IAAI;QACpC,OAAO,CAAC,qBAAqB,EAAE,CAAA,CAAC,SAAS;QAEzC,aAAa;QACb,KAAK,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAA;QAEvC,MAAM,CAAC,OAAO,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAA;IACzD,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACrC,MAAM,OAAO,GAAG,EAAE,CAAC,EAAE,EAAE,CAAA;QAEvB,IAAI,eAAe,CAAC;YAClB,KAAK;YACL,OAAO;YACP,SAAS,EAAE,EAAE,OAAO,EAAE;SACvB,CAAC,CAAA;QAEF,2BAA2B;QAC3B,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE;YACpC,KAAK,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,eAAe,EAAE;SAC7D,CAAC,CAAA;QAEF,aAAa;QACb,KAAK,CAAC,aAAa,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAA;QAEvC,MAAM,CAAC,OAAO,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAA;IACzD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/components/LiveVideoPlayer/hooks/useHlsVideo/classes/__tests__/RecoveryTracker.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=RecoveryTracker.test.d.ts.map

package/dist/components/LiveVideoPlayer/hooks/useHlsVideo/classes/__tests__/RecoveryTracker.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecoveryTracker.test.d.ts","sourceRoot":"","sources":["../../../../../../../src/components/LiveVideoPlayer/hooks/useHlsVideo/classes/__tests__/RecoveryTracker.test.ts"],"names":[],"mappings":""}

package/dist/components/LiveVideoPlayer/hooks/useHlsVideo/classes/__tests__/RecoveryTracker.test.js

@@ -0,0 +1,74 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { RecoveryTracker } from '../RecoveryTracker';
+describe('RecoveryTracker', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    describe('shouldAttemptRecovery', () => {
+        it('初回のリカバリ試行は true を返す', () => {
+            const tracker = new RecoveryTracker();
+            expect(tracker.shouldAttemptRecovery()).toBe(true);
+        });
+        it('5秒以内の連続リカバリは試行回数をカウントアップ', () => {
+            const tracker = new RecoveryTracker();
+            expect(tracker.shouldAttemptRecovery()).toBe(true); // 1回目
+            vi.advanceTimersByTime(1000); // 1秒後
+            expect(tracker.shouldAttemptRecovery()).toBe(true); // 2回目
+            vi.advanceTimersByTime(1000); // さらに1秒後
+            expect(tracker.shouldAttemptRecovery()).toBe(true); // 3回目
+            vi.advanceTimersByTime(1000); // さらに1秒後
+            expect(tracker.shouldAttemptRecovery()).toBe(false); // 4回目: 上限超過
+        });
+        it('5秒以上経過するとカウントがリセットされる', () => {
+            const tracker = new RecoveryTracker();
+            expect(tracker.shouldAttemptRecovery()).toBe(true); // 1回目
+            vi.advanceTimersByTime(1000);
+            expect(tracker.shouldAttemptRecovery()).toBe(true); // 2回目
+            vi.advanceTimersByTime(1000);
+            expect(tracker.shouldAttemptRecovery()).toBe(true); // 3回目
+            // 5秒以上経過
+            vi.advanceTimersByTime(6000);
+            expect(tracker.shouldAttemptRecovery()).toBe(true); // リセットされて1回目として扱われる
+        });
+    });
+    describe('reset', () => {
+        it('リカバリカウントをリセット', () => {
+            const tracker = new RecoveryTracker();
+            // 3回試行
+            tracker.shouldAttemptRecovery();
+            vi.advanceTimersByTime(100);
+            tracker.shouldAttemptRecovery();
+            vi.advanceTimersByTime(100);
+            tracker.shouldAttemptRecovery();
+            vi.advanceTimersByTime(100);
+            // 4回目は失敗するはず
+            expect(tracker.shouldAttemptRecovery()).toBe(false);
+            // リセット
+            tracker.reset();
+            // リセット後は再度成功
+            expect(tracker.shouldAttemptRecovery()).toBe(true);
+        });
+        it('エラー報告フラグもリセット', () => {
+            const tracker = new RecoveryTracker();
+            tracker.markErrorReported();
+            expect(tracker.isErrorReported).toBe(true);
+            tracker.reset();
+            expect(tracker.isErrorReported).toBe(false);
+        });
+    });
+    describe('isErrorReported / markErrorReported', () => {
+        it('初期状態は false', () => {
+            const tracker = new RecoveryTracker();
+            expect(tracker.isErrorReported).toBe(false);
+        });
+        it('markErrorReported で true になる', () => {
+            const tracker = new RecoveryTracker();
+            tracker.markErrorReported();
+            expect(tracker.isErrorReported).toBe(true);
+        });
+    });
+});
+//# sourceMappingURL=RecoveryTracker.test.js.map

package/dist/components/LiveVideoPlayer/hooks/useHlsVideo/classes/__tests__/RecoveryTracker.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecoveryTracker.test.js","sourceRoot":"","sources":["../../../../../../../src/components/LiveVideoPlayer/hooks/useHlsVideo/classes/__tests__/RecoveryTracker.test.ts"],"names":[],"mappings":"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"}

package/dist/components/LiveVideoPlayer/hooks/useHlsVideo/index.d.ts

@@ -0,0 +1,31 @@
+import { VideoTexture } from 'three';
+export interface UseHlsVideoOptions {
+    /** HLS動画URL */
+    url: string;
+    /** キャッシュバスター用キー */
+    cacheKey?: number;
+    /** 再生中かどうか */
+    playing: boolean;
+    /** 音量 0〜1 */
+    volume: number;
+    /** エラー発生時のコールバック */
+    onError?: (error: Error) => void;
+    /** バッファリング状態変更時のコールバック */
+    onBufferingChange?: (buffering: boolean) => void;
+}
+export interface UseHlsVideoReturn {
+    /** 動画テクスチャ */
+    texture: VideoTexture;
+    /** 動画要素への参照 */
+    videoRef: React.RefObject<HTMLVideoElement>;
+}
+/**
+ * HLSストリーム専用のビデオ要素管理フック
+ *
+ * - hls.js を使用（Safari以外）
+ * - Native HLS support を使用（Safari）
+ * - recoverMediaError() によるエラーリカバリ
+ * - リカバリ失敗時のみ完全リロード
+ */
+export declare function useHlsVideo({ url, cacheKey, playing, volume, onError, onBufferingChange, }: UseHlsVideoOptions): UseHlsVideoReturn;
+//# sourceMappingURL=index.d.ts.map

package/dist/components/LiveVideoPlayer/hooks/useHlsVideo/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/LiveVideoPlayer/hooks/useHlsVideo/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAMpC,MAAM,WAAW,kBAAkB;IACjC,eAAe;IACf,GAAG,EAAE,MAAM,CAAA;IACX,mBAAmB;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,cAAc;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,aAAa;IACb,MAAM,EAAE,MAAM,CAAA;IACd,oBAAoB;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAChC,0BAA0B;IAC1B,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAA;CACjD;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc;IACd,OAAO,EAAE,YAAY,CAAA;IACrB,eAAe;IACf,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAA;CAC5C;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,EAC1B,GAAG,EACH,QAAY,EACZ,OAAO,EACP,MAAM,EACN,OAAO,EACP,iBAAiB,GAClB,EAAE,kBAAkB,GAAG,iBAAiB,CA8GxC"}

package/dist/components/LiveVideoPlayer/hooks/useHlsVideo/index.js

@@ -0,0 +1,108 @@
+import { useEffect, useRef, useState } from 'react';
+import { useWebAudioVolume } from '../../../../hooks/useWebAudioVolume';
+import { appendCacheKey, createVideoTexture, createHlsPlayer } from './utils';
+import { RecoveryTracker } from './classes/RecoveryTracker';
+/**
+ * HLSストリーム専用のビデオ要素管理フック
+ *
+ * - hls.js を使用（Safari以外）
+ * - Native HLS support を使用（Safari）
+ * - recoverMediaError() によるエラーリカバリ
+ * - リカバリ失敗時のみ完全リロード
+ */
+export function useHlsVideo({ url, cacheKey = 0, playing, volume, onError, onBufferingChange, }) {
+    const videoRef = useRef(null);
+    const textureRef = useRef(null);
+    const playerRef = useRef(null);
+    const recoveryTrackerRef = useRef(new RecoveryTracker());
+    // テクスチャを状態として保持（初回レンダリング時に同期的に作成）
+    const [texture] = useState(() => {
+        const { video, texture: tex } = createVideoTexture();
+        videoRef.current = video;
+        textureRef.current = tex;
+        return tex;
+    });
+    // プレイヤーの初期化
+    useEffect(() => {
+        const video = videoRef.current;
+        if (!video)
+            return;
+        const urlWithCacheKey = appendCacheKey(url, cacheKey);
+        const tracker = recoveryTrackerRef.current;
+        tracker.reset();
+        let player = null;
+        const init = async () => {
+            const result = await createHlsPlayer({
+                video,
+                tracker,
+                callbacks: {
+                    onError,
+                    onBufferingChange,
+                    onManifestParsed: () => {
+                        if (playing) {
+                            video.play().catch((err) => console.error('[useHlsVideo] Play error after manifest parsed:', err));
+                        }
+                    },
+                },
+            });
+            if (result.type === 'unsupported') {
+                onError?.(result.error);
+                return;
+            }
+            player = result.player;
+            playerRef.current = player;
+            player.load(urlWithCacheKey);
+        };
+        init();
+        return () => {
+            if (player) {
+                player.destroy();
+                playerRef.current = null;
+            }
+            video.pause();
+            video.src = '';
+            video.load();
+        };
+    }, [url, cacheKey, onError, onBufferingChange, playing]);
+    // 再生/停止制御
+    useEffect(() => {
+        const video = videoRef.current;
+        if (!video)
+            return;
+        if (playing) {
+            video.play().catch((err) => console.error('[useHlsVideo] Play error:', err));
+        }
+        else {
+            video.pause();
+        }
+    }, [playing]);
+    // バッファリング状態の監視
+    useEffect(() => {
+        const video = videoRef.current;
+        if (!video)
+            return;
+        const handleWaiting = () => onBufferingChange?.(true);
+        const handlePlaying = () => onBufferingChange?.(false);
+        const handleCanPlay = () => onBufferingChange?.(false);
+        video.addEventListener('waiting', handleWaiting);
+        video.addEventListener('playing', handlePlaying);
+        video.addEventListener('canplay', handleCanPlay);
+        return () => {
+            video.removeEventListener('waiting', handleWaiting);
+            video.removeEventListener('playing', handlePlaying);
+            video.removeEventListener('canplay', handleCanPlay);
+        };
+    }, [onBufferingChange]);
+    // Web Audio API を使用した音量制御（iOS対応）
+    useWebAudioVolume(videoRef.current, volume);
+    // クリーンアップ
+    useEffect(() => {
+        return () => {
+            if (textureRef.current) {
+                textureRef.current.dispose();
+            }
+        };
+    }, []);
+    return { texture, videoRef };
+}
+//# sourceMappingURL=index.js.map

package/dist/components/LiveVideoPlayer/hooks/useHlsVideo/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/components/LiveVideoPlayer/hooks/useHlsVideo/index.ts"],"names":[],"mappings":"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"}

package/dist/components/LiveVideoPlayer/hooks/useHlsVideo/types.d.ts

@@ -0,0 +1,34 @@
+import type { VideoTexture } from 'three';
+import type { RecoveryTracker } from './classes/RecoveryTracker';
+export interface HlsPlayerCallbacks {
+    onError?: (error: Error) => void;
+    onBufferingChange?: (buffering: boolean) => void;
+    onManifestParsed?: () => void;
+}
+export interface HlsPlayerOptions {
+    video: HTMLVideoElement;
+    tracker: RecoveryTracker;
+    callbacks: HlsPlayerCallbacks;
+}
+/** HLS プレイヤーの共通インターフェース */
+export interface HlsPlayerStrategy {
+    /** ソースを読み込む */
+    load(url: string): void;
+    /** リソースを解放 */
+    destroy(): void;
+    /** メディアエラーからのリカバリを試行 */
+    attemptRecovery(): boolean;
+}
+export interface VideoTextureResult {
+    video: HTMLVideoElement;
+    texture: VideoTexture;
+}
+export type CreatePlayerResult = {
+    player: HlsPlayerStrategy;
+    type: 'hlsjs' | 'native';
+} | {
+    player: null;
+    type: 'unsupported';
+    error: Error;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/components/LiveVideoPlayer/hooks/useHlsVideo/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/components/LiveVideoPlayer/hooks/useHlsVideo/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AACzC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAEhE,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAChC,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAA;IAChD,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAA;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,gBAAgB,CAAA;IACvB,OAAO,EAAE,eAAe,CAAA;IACxB,SAAS,EAAE,kBAAkB,CAAA;CAC9B;AAED,2BAA2B;AAC3B,MAAM,WAAW,iBAAiB;IAChC,eAAe;IACf,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,cAAc;IACd,OAAO,IAAI,IAAI,CAAA;IACf,wBAAwB;IACxB,eAAe,IAAI,OAAO,CAAA;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,gBAAgB,CAAA;IACvB,OAAO,EAAE,YAAY,CAAA;CACtB;AAED,MAAM,MAAM,kBAAkB,GAC1B;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAA;CAAE,GACvD;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAA"}

package/dist/components/LiveVideoPlayer/hooks/useHlsVideo/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/components/LiveVideoPlayer/hooks/useHlsVideo/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/components/LiveVideoPlayer/hooks/useHlsVideo/types.ts"],"names":[],"mappings":""}

package/dist/components/LiveVideoPlayer/hooks/useHlsVideo/utils.d.ts

@@ -0,0 +1,15 @@
+import type { HlsPlayerOptions, CreatePlayerResult, VideoTextureResult } from './types';
+/** URLがHLSストリームかどうかを判定 */
+export declare function isHlsUrl(url: string): boolean;
+/** Safari（native HLS対応ブラウザ）かどうかを判定 */
+export declare function canPlayHlsNatively(): boolean;
+/** URLにキャッシュバスター用のキーを付与 */
+export declare function appendCacheKey(url: string, cacheKey: number): string;
+/** HLS再生用のvideo要素とテクスチャを作成 */
+export declare function createVideoTexture(): VideoTextureResult;
+/**
+ * 環境に応じて適切な HLS プレイヤーを作成
+ * hls.js を優先し、利用できない場合はネイティブ HLS にフォールバック
+ */
+export declare function createHlsPlayer(options: HlsPlayerOptions): Promise<CreatePlayerResult>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/components/LiveVideoPlayer/hooks/useHlsVideo/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../src/components/LiveVideoPlayer/hooks/useHlsVideo/utils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAEvF,0BAA0B;AAC1B,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE7C;AAED,sCAAsC;AACtC,wBAAgB,kBAAkB,IAAI,OAAO,CAI5C;AAED,2BAA2B;AAC3B,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,8BAA8B;AAC9B,wBAAgB,kBAAkB,IAAI,kBAAkB,CAYvD;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,kBAAkB,CAAC,CA4B7B"}