react-native-alpha-video 1.0.0 → 1.0.1

package/README.md

@@ -20,7 +20,7 @@ One repository, four packages. The software decoders are [codec modules](#codecs
 |---|---|---|
 | `react-native-alpha-video` (npm) | React Native, and react-native-web | [React Native](#react-native) |
 | `dev.mediacache:alpha-video` (Maven Central), with `alpha-video-vpx` and `alpha-video-av1` | Android | [Android](#android) |
-| `alpha-video` (Swift Package Manager: products `AlphaVideoVPX`, `AlphaVideoAV1`; CocoaPods: `alpha-video`) | iOS | [iOS](#ios) |
+| `alpha-video` (Swift Package Manager: products `AlphaVideoVPX`, `AlphaVideoAV1`, `AlphaVideoSource`; CocoaPods: `alpha-video`) | iOS | [iOS](#ios) |
 | `alpha-video-web` (npm) | Browsers: plain JS/TS, or React | [Web](#web), [web/README.md](web/README.md) |
 
 See it next to the other formats in the [demo app](#demo-and-related-packages).
@@ -171,9 +171,9 @@ The package works on both React Native architectures: the new one (a Fabric view
 
 ```gradle
 dependencies {
-    implementation 'dev.mediacache:alpha-video:1.0.0'
-    implementation 'dev.mediacache:alpha-video-vpx:1.0.0'  // libvpx: VP8 and VP9 in software
-    implementation 'dev.mediacache:alpha-video-av1:1.0.0'  // dav1d: AV1 in software
+    implementation 'dev.mediacache:alpha-video:1.0.1'
+    implementation 'dev.mediacache:alpha-video-vpx:1.0.1'  // libvpx: VP8 and VP9 in software
+    implementation 'dev.mediacache:alpha-video-av1:1.0.1'  // dav1d: AV1 in software
 }
 ```
 
@@ -182,7 +182,7 @@ The core alone plays through MediaCodec; each codec module adds a software decod
 The core brings [range-source](https://github.com/MediaCacheDev/range-source) (`dev.mediacache:range-source`, about 320 KB per architecture), which reads URLs by range and keeps them between plays. To leave it out ([Without range-source](#without-range-source)):
 
 ```gradle
-implementation('dev.mediacache:alpha-video:1.0.0') {
+implementation('dev.mediacache:alpha-video:1.0.1') {
     exclude group: 'dev.mediacache', module: 'range-source'
 }
 ```
@@ -230,18 +230,19 @@ pod 'alpha-video', '1.0.0'
 pod 'alpha-video', '1.0.0', :subspecs => ['VPX', 'Source']
 ```
 
-**Swift Package Manager**, package `alpha-video`, a product per codec, each with the core:
+**Swift Package Manager**, package `alpha-video`, a product per codec, each with the core, and `AlphaVideoSource` for range-source:
 
 ```swift
-.package(url: "https://github.com/MediaCacheDev/alpha-video", from: "1.0.0")
-// in the target's dependencies, one or both:
+.package(url: "https://github.com/MediaCacheDev/alpha-video", from: "1.0.1")
+// in the target's dependencies, one codec or both, and range-source:
 .product(name: "AlphaVideoVPX", package: "alpha-video"),
 .product(name: "AlphaVideoAV1", package: "alpha-video"),
+.product(name: "AlphaVideoSource", package: "alpha-video"),
 ```
 
-The module is `AlphaVideo` either way. libvpx and dav1d come prebuilt, each with its codec.
+In an Xcode project, add the package (File > Add Package Dependencies) and pick the same products for the app target. The module is `AlphaVideo` either way. libvpx and dav1d come prebuilt, each with its codec.
 
-Both bring [range-source](https://github.com/MediaCacheDev/range-source), which reads URLs by range and keeps them between plays: the pod's `Source` subspec, and the package's default trait, `Source` (Swift 6.1, Xcode 16.3 or later). To leave it out ([Without range-source](#without-range-source)), name the pod's subspecs without it, `:subspecs => ['VPX', 'AV1']`. From a package, depend on the player with `traits: []`. An Xcode app project can't choose a package's traits, so an app that adds the package in Xcode always has range-source.
+Both include [range-source](https://github.com/MediaCacheDev/range-source), which reads URLs by range and keeps them between plays, by default: the pod's `Source` subspec, and the package's `AlphaVideoSource` product. To leave it out ([Without range-source](#without-range-source)), name the pod's subspecs without it, `:subspecs => ['VPX', 'AV1']`, or don't add `AlphaVideoSource`. It's a product rather than a package trait because Xcode before 26.4 applies no package traits, default ones included.
 
 `AlphaVideoView` is a `UIView`:
 
@@ -317,7 +318,7 @@ The player automatically detects whether a file contains a single YUVA stream or
 
 The examples under [Installation](#installation) and [Usage](#usage) set every option, each to its default. `paused`, `playbackSpeed` and `verbose` change at once; the others are read when a source loads, so set them before the source.
 
-iOS has no `decoder`: it always decodes in software. The prefetch and queue settings apply to the C++ core's software decoding; MediaCodec on Android streams with its own buffers and ignores them, and so does the web, where the browser plays the file. On the web `mode`, `decoder`, `source.dataSource` and the stream and queue props have no effect (see [Web](#web)).
+iOS has no `decoder`: it always decodes in software. The prefetch and queue settings apply to the C++ core's software decoding; MediaCodec on Android streams with its own buffers and ignores them, and so does the web, where the browser plays the file. On the web `mode`, `decoder` and the stream and queue props have no effect (see [Web](#web)).
 
 ### Props
 
@@ -532,7 +533,11 @@ final class MyDataSource: NSObject, RangeDataSource {
 RangeDataSources.register(MyDataSource(), name: "mine")
 ```
 
-**React Native:** register in native code, as above, in `MainApplication` (Android) and `AppDelegate` (iOS, `import RangeSource`).
+**React Native:** register in native code, as above, in `MainApplication` (Android) and `AppDelegate` (iOS, `import RangeSource`). On react-native-web, register a function that makes a byte source for a URI with range-source-web (1.2.0 or later): `RangeDataSources.register('mine', (uri, { headers }) => myByteSource(uri, headers))`.
+
+**MediaCache** is a data source on Android, iOS, React Native (react-native-web included) and the web. `cache.registerRangeDataSource()` registers it as `'mediacache'`. The player's files then stream through the cache: each byte is fetched once, shared with every other player of the file, and kept under the cache's eviction, TTL and offline replay. See [Transparent Video](https://github.com/MediaCacheDev/media-cache#transparent-video-alpha-video-and-alpha-video-gpu) in MediaCache's README.
+
+MediaCache needs range-source on Android, iOS and React Native: MediaCache fetches and stores the bytes, and range-source passes the player's reads to it. range-source is included by default ([Installation](#installation)), but an app that left it out has to add it back, and `registerRangeDataSource` returns false without it. On the web, the player's range-source-web is always included.
 
 ### Web
 
@@ -544,9 +549,9 @@ RangeDataSources.register(MyDataSource(), name: "mine")
 
 Only a file that no engine can decode ends in an error (`NO_ALPHA_PATH`). Each WebAssembly module is loaded only when its engine runs, and nothing needs hosting: the modules and Workers are inside the package. Every test card passes through every engine that can decode it, in Playwright's Chromium, Firefox and WebKit; real Safari and phones are still to be tested. The API, the React component and speed figures are in [web/README.md](web/README.md).
 
-**On react-native-web, `AlphaVideoView` plays through `alpha-video-web`**, which is installed with this package. iOS and Android bundles don't include it: the component imports it from a `.web.tsx` file. It honours `source` (with `source.headers`, sent with every request; on the web `source` can also be a `Blob` or `File`, or a byte source, `{ size, read(offset, length, signal) }`, kept as the same object between renders), `cacheKey` (naming the stored copy), `storage` (`'disk'` is the browser's storage, as `'auto'`), `maxStorageBytes`, `autoPlay`, `loop`, `paused`, `playbackSpeed`, `webDecoder`, `onLoad`, `onError`, `onEnd` and the ref methods. `mode`, `decoder`, `source.dataSource` and the stream and queue props have no effect. `asset://path` is served from the site root.
+**On react-native-web, `AlphaVideoView` plays through `alpha-video-web`**, which is installed with this package. iOS and Android bundles don't include it: the component imports it from a `.web.tsx` file. It honours `source` (with `source.headers`, sent with every request; on the web `source` can also be a `Blob` or `File`, or a byte source, `{ size, read(offset, length, signal) }`, kept as the same object between renders), `cacheKey` (naming the stored copy), `storage` (`'disk'` is the browser's storage, as `'auto'`), `maxStorageBytes`, `autoPlay`, `loop`, `paused`, `playbackSpeed`, `webDecoder`, `onLoad`, `onError`, `onEnd` and the ref methods, and `source.dataSource`, a name registered with range-source-web ([Data sources](#data-sources)). `mode`, `decoder` and the stream and queue props have no effect. `asset://path` is served from the site root.
 
-- **Bundling:** the WebAssembly engines are separate chunks, loaded by `import()` only when a file needs them. With webpack, Vite or esbuild that needs nothing extra.
+- **Bundling:** the demuxer and the WebAssembly engines are separate chunks, loaded by `import()` only when a file needs them. With webpack, Vite or esbuild that needs nothing extra. Metro loads them through `@expo/metro-runtime`: Expo Router apps have it, and other Expo apps add `import '@expo/metro-runtime';` at the top of their entry file.
 - **Storage for `<video>`:** copy `range-source-web/dist/range-source-sw.js` to the site's root and call `registerRangeSourceWorker('/range-source-sw.js')` from `alpha-video-web` before `AppRegistry.runApplication` ([details](web/README.md#video-and-the-service-worker)).
 - **Content-Security-Policy:** the software engine's Workers start from `blob:` URLs, so a page with a CSP must allow `worker-src blob:`.
 - **Threads:** a cross-origin isolated page (COOP and COEP headers) lets the software decoders run threads ([details](web/README.md#threads)).
@@ -836,7 +841,7 @@ The fixtures in `tests/fixtures/` are test cards from the tester app: every fram
 
 The host tests need CMake, Ninja, pkg-config, libvpx and dav1d (`brew install cmake ninja pkg-config libvpx dav1d`; add `ffmpeg` for `demuxer_compare`), and a [range-source](https://github.com/MediaCacheDev/range-source) checkout beside this repository (or `-DRANGE_SOURCE_DIR=`), whose reader they link as an app does. The web tests need `npm install` and `npm run build` in `web/` first, and Playwright's browsers (`npx playwright install chromium firefox webkit`); `test:streaming` makes its clip with ffmpeg.
 
-The iOS tests are Swift Package test targets: `VPXOnlyTests` and `AV1OnlyTests` each link one codec module alone, so they run one at a time, and `SourceTests` links range-source. `tests/ios/WithoutRangeSource` is a package that depends on this one with `traits: []`, as an app leaving range-source out does. They need the codec xcframeworks: with `prebuilt/` in place (see [Codec Build](#codec-build)), `scripts/build_xcframework.sh` makes them there, where `Package.swift` looks first. `RANGE_SOURCE_PATH` points them at a range-source checkout instead of its release.
+The iOS tests are Swift Package test targets: `VPXOnlyTests` and `AV1OnlyTests` each link one codec module alone, so they run one at a time, and `SourceTests` links range-source. `tests/ios/WithoutRangeSource` is a package that takes `AlphaVideoVPX` without `AlphaVideoSource`, as an app leaving range-source out does. They need the codec xcframeworks: with `prebuilt/` in place (see [Codec Build](#codec-build)), `scripts/build_xcframework.sh` makes them there, where `Package.swift` looks first. `RANGE_SOURCE_PATH` points them at a range-source checkout instead of its release.
 
 ```bash
 for t in VPXOnlyTests AV1OnlyTests SourceTests; do

package/android/build.gradle

@@ -21,7 +21,7 @@ def safeExtGet(name, fallback) {
 }
 
 group = 'dev.mediacache'
-version = '1.0.0'
+version = '1.0.1'
 
 android {
     namespace 'dev.mediacache.alphavideo'
@@ -31,6 +31,7 @@ android {
     defaultConfig {
         minSdk safeExtGet('minSdkVersion', 24)
         consumerProguardFiles 'consumer-rules.pro'
+        testInstrumentationRunner 'androidx.test.runner.AndroidJUnitRunner'
 
         externalNativeBuild {
             cmake {
@@ -78,6 +79,10 @@ dependencies {
     // Included by default and removable: an app can exclude it, and the player then falls back
     // to the basic input (RangeSourceLink)
     api 'dev.mediacache:range-source:1.0.0'
+
+    androidTestImplementation 'androidx.test:core:1.6.1'
+    androidTestImplementation 'androidx.test:runner:1.6.2'
+    androidTestImplementation 'androidx.test.ext:junit:1.2.1'
 }
 
 if (project == rootProject) {

package/android/src/main/java/dev/mediacache/alphavideo/AlphaVideoView.java

@@ -27,6 +27,7 @@ import java.util.Map;
 import java.util.concurrent.ExecutorService;
 import java.util.concurrent.Executors;
 import java.util.concurrent.Future;
+import java.util.concurrent.RejectedExecutionException;
 import java.util.concurrent.atomic.AtomicBoolean;
 
 /**
@@ -1017,7 +1018,7 @@ public class AlphaVideoView extends TextureView implements
         this.surfaceHeight = height;
         
         // Update viewport on render thread
-        renderThread.execute(() -> {
+        onRenderThread(() -> {
             if (eglSurface != null && eglContext != null) {
                 makeCurrent();
                 GLES20.glViewport(0, 0, width, height);
@@ -1036,14 +1037,9 @@ public class AlphaVideoView extends TextureView implements
         this.surfaceTexture = null;
         
         // Clean up EGL on render thread WITHOUT blocking main thread
-        // This prevents ANRs when multiple players are destroyed simultaneously
-        renderThread.execute(() -> {
-            try {
-                destroyEGL();
-            } catch (Exception e) {
-                Log.e(TAG, "Error during EGL cleanup: " + e.getMessage());
-            }
-        });
+        // This prevents ANRs when multiple players are destroyed simultaneously.
+        // After release() there is no render thread, and release() has cleaned up already.
+        onRenderThread(this::destroyEGLSafely);
         
         // Return false - we'll manage SurfaceTexture lifecycle ourselves to avoid blocking
         // The render thread will clean up EGL and we don't need the SurfaceTexture after that
@@ -1355,8 +1351,28 @@ public class AlphaVideoView extends TextureView implements
     
     private void requestRender() {
         // Prevent queuing multiple render calls
-        if (renderPending.compareAndSet(false, true)) {
-            renderThread.execute(this::doRender);
+        if (renderPending.compareAndSet(false, true) && !onRenderThread(this::doRender)) {
+            renderPending.set(false);
+        }
+    }
+
+    /** Runs a task on the render thread. False when there is none, after {@link #release()}. */
+    private boolean onRenderThread(Runnable task) {
+        ExecutorService thread = renderThread;
+        if (thread == null || thread.isShutdown()) return false;
+        try {
+            thread.execute(task);
+            return true;
+        } catch (RejectedExecutionException e) {
+            return false;
+        }
+    }
+
+    private void destroyEGLSafely() {
+        try {
+            destroyEGL();
+        } catch (Exception e) {
+            Log.e(TAG, "Error during EGL cleanup: " + e.getMessage());
         }
     }
     
@@ -1778,8 +1794,8 @@ public class AlphaVideoView extends TextureView implements
             }
         }
         
-        // Shutdown render thread
-        if (renderThread != null && !renderThread.isShutdown()) {
+        // Shutdown render thread, freeing EGL on it first: the surface going away later can't
+        if (onRenderThread(this::destroyEGLSafely)) {
             renderThread.shutdown();
         }
     }

package/ios/Sources/AlphaVideo/AlphaVideoView.mm

@@ -48,7 +48,7 @@ static const int64_t AlphaVideoDefaultMaxStorageBytes = 512LL * 1024 * 1024;
 static void AlphaVideoWarnWithoutAddOn(void) {
     static dispatch_once_t once;
     dispatch_once(&once, ^{
-        NSLog(@"[AlphaVideo] range-source isn't installed (the RangeSource SwiftPM product, the alpha-video pod's "
+        NSLog(@"[AlphaVideo] range-source isn't installed (the AlphaVideoSource SwiftPM product, the alpha-video pod's "
               @"Source subspec, or for React Native npm i react-native-range-source): URLs are downloaded whole for "
               @"each play, without range requests, storage, maxStorageBytes or cacheKey");
     });
@@ -240,7 +240,7 @@ static void AlphaVideoWarnWithoutAddOn(void) {
     if (!AlphaVideoRangeSourcePlugin()) {
         if (appSource) {
             [self playerDidEncounterError:[NSString stringWithFormat:
-                @"The data source \"%@\" needs the range-source add-on (the RangeSource SwiftPM product, the "
+                @"The data source \"%@\" needs the range-source add-on (the AlphaVideoSource SwiftPM product, the "
                 @"alpha-video pod's Source subspec, or for React Native react-native-range-source), which the "
                 @"app doesn't include", self.dataSource]
                                      code:AlphaVideoErrorNoSourceModule];

package/ios/Sources/AlphaVideo/include/AlphaVideo.h

@@ -20,7 +20,7 @@ extern NSString *const AlphaVideoErrorNoDecoder;
 
 /**
  * The error code for a data source without the range-source add-on, which reads them (the
- * RangeSource SwiftPM product, the alpha-video pod's Source subspec, or for React Native
+ * AlphaVideoSource SwiftPM product, the alpha-video pod's Source subspec, or for React Native
  * react-native-range-source).
  */
 extern NSString *const AlphaVideoErrorNoSourceModule;

package/lib/commonjs/WebPlayer.web.js

@@ -19,6 +19,11 @@ function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r
 /** asset://path names the app's bundled media; on the web it is served from the site root. */function toWebUrl(uri) {
   return uri.startsWith('asset://') ? '/' + uri.slice('asset://'.length).replace(/^\/+/, '') : uri;
 }
+/** range-source-web's `RangeDataSources`, read from its global symbol so this package needn't depend on it. */
+function registeredDataSource(name) {
+  const scope = globalThis;
+  return scope[Symbol.for('range-source.dataSources')]?.get(name);
+}
 const WebPlayer = exports.WebPlayer = /*#__PURE__*/(0, _react.forwardRef)((props, ref) => {
   const {
     source,
@@ -40,9 +45,25 @@ const WebPlayer = exports.WebPlayer = /*#__PURE__*/(0, _react.forwardRef)((props
     onEnd
   } = props;
   // Streamed by range from http(s) URLs and kept in the browser's storage (OPFS, else IndexedDB)
-  // by the canvas engines; <video> uses the HTTP cache. A Blob or byte source plays as it is.
+  // by the canvas engines; <video> uses the HTTP cache. A Blob or byte source plays as it is, and
+  // a `dataSource` name plays the byte source registered under it, which keeps the bytes itself.
   const uriSource = (0, _AlphaVideoView.isUriSource)(source) ? source : undefined;
-  const src = (0, _AlphaVideoView.isUriSource)(source) ? source.uri ? toWebUrl(source.uri) : undefined : source;
+  const dataSource = uriSource?.dataSource;
+  const headersKey = JSON.stringify(uriSource?.headers ?? null);
+  const fromDataSource = (0, _react.useMemo)(() => dataSource && uriSource?.uri ? registeredDataSource(dataSource)?.(uriSource.uri, {
+    headers: uriSource.headers
+  }) ?? null : null,
+  // eslint-disable-next-line react-hooks/exhaustive-deps
+  [dataSource, uriSource?.uri, headersKey]);
+  const src = dataSource ? fromDataSource : (0, _AlphaVideoView.isUriSource)(source) ? source.uri ? toWebUrl(source.uri) : undefined : source;
+  (0, _react.useEffect)(() => {
+    if (dataSource && uriSource?.uri && !fromDataSource) {
+      onError?.({
+        error: `No data source is registered on the web under "${dataSource}"`
+      });
+    }
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [fromDataSource, dataSource, uriSource?.uri]);
   return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
     style: [styles.container, style],
     children: src ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_react2.AlphaVideo, {
@@ -53,8 +74,10 @@ const WebPlayer = exports.WebPlayer = /*#__PURE__*/(0, _react.forwardRef)((props
       paused: paused,
       playbackSpeed: playbackSpeed,
       decoder: webDecoder,
-      headers: uriSource?.headers,
-      cacheKey: uriSource?.cacheKey || cacheKey,
+      headers: dataSource ? undefined : uriSource?.headers,
+      cacheKey:
+      // As on Android and iOS, a data source's bytes are stored only when storage is set
+      dataSource && storage !== 'disk' && storage !== 'memory' ? undefined : uriSource?.cacheKey || cacheKey || (dataSource ? uriSource?.uri : undefined),
       storage: storage === 'disk' ? 'auto' : storage,
       maxStorageBytes: maxStorageBytes,
       style: fill,

package/lib/commonjs/WebPlayer.web.js.map

@@ -1 +1 @@
-{"version":3,"names":["_react","_interopRequireWildcard","require","_reactNative","_react2","_AlphaVideoView","_jsxRuntime","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","toWebUrl","uri","startsWith","slice","length","replace","WebPlayer","exports","forwardRef","props","ref","source","autoPlay","loop","paused","playbackSpeed","webDecoder","cacheKey","storage","maxStorageBytes","style","onLoad","onError","onEnd","uriSource","isUriSource","undefined","src","jsx","View","styles","container","children","AlphaVideo","decoder","headers","fill","totalFrames","width","height","error","message","code","displayName","StyleSheet","create","overflow"],"sourceRoot":"../../react-native/src","sources":["WebPlayer.web.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_react","_interopRequireWildcard","require","_reactNative","_react2","_AlphaVideoView","_jsxRuntime","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","toWebUrl","uri","startsWith","slice","length","replace","registeredDataSource","name","scope","globalThis","Symbol","for","WebPlayer","exports","forwardRef","props","ref","source","autoPlay","loop","paused","playbackSpeed","webDecoder","cacheKey","storage","maxStorageBytes","style","onLoad","onError","onEnd","uriSource","isUriSource","undefined","dataSource","headersKey","JSON","stringify","headers","fromDataSource","useMemo","src","useEffect","error","jsx","View","styles","container","children","AlphaVideo","decoder","fill","totalFrames","width","height","message","code","displayName","StyleSheet","create","overflow"],"sourceRoot":"../../react-native/src","sources":["WebPlayer.web.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/WebPlayer.web.js

@@ -19,6 +19,11 @@ function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r
 /** asset://path names the app's bundled media; on the web it is served from the site root. */function toWebUrl(uri) {
   return uri.startsWith('asset://') ? '/' + uri.slice('asset://'.length).replace(/^\/+/, '') : uri;
 }
+/** range-source-web's `RangeDataSources`, read from its global symbol so this package needn't depend on it. */
+function registeredDataSource(name) {
+  const scope = globalThis;
+  return scope[Symbol.for('range-source.dataSources')]?.get(name);
+}
 const WebPlayer = exports.WebPlayer = /*#__PURE__*/(0, _react.forwardRef)((props, ref) => {
   const {
     source,
@@ -40,9 +45,25 @@ const WebPlayer = exports.WebPlayer = /*#__PURE__*/(0, _react.forwardRef)((props
     onEnd
   } = props;
   // Streamed by range from http(s) URLs and kept in the browser's storage (OPFS, else IndexedDB)
-  // by the canvas engines; <video> uses the HTTP cache. A Blob or byte source plays as it is.
+  // by the canvas engines; <video> uses the HTTP cache. A Blob or byte source plays as it is, and
+  // a `dataSource` name plays the byte source registered under it, which keeps the bytes itself.
   const uriSource = (0, _AlphaVideoView.isUriSource)(source) ? source : undefined;
-  const src = (0, _AlphaVideoView.isUriSource)(source) ? source.uri ? toWebUrl(source.uri) : undefined : source;
+  const dataSource = uriSource?.dataSource;
+  const headersKey = JSON.stringify(uriSource?.headers ?? null);
+  const fromDataSource = (0, _react.useMemo)(() => dataSource && uriSource?.uri ? registeredDataSource(dataSource)?.(uriSource.uri, {
+    headers: uriSource.headers
+  }) ?? null : null,
+  // eslint-disable-next-line react-hooks/exhaustive-deps
+  [dataSource, uriSource?.uri, headersKey]);
+  const src = dataSource ? fromDataSource : (0, _AlphaVideoView.isUriSource)(source) ? source.uri ? toWebUrl(source.uri) : undefined : source;
+  (0, _react.useEffect)(() => {
+    if (dataSource && uriSource?.uri && !fromDataSource) {
+      onError?.({
+        error: `No data source is registered on the web under "${dataSource}"`
+      });
+    }
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [fromDataSource, dataSource, uriSource?.uri]);
   return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
     style: [styles.container, style],
     children: src ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_react2.AlphaVideo, {
@@ -53,8 +74,10 @@ const WebPlayer = exports.WebPlayer = /*#__PURE__*/(0, _react.forwardRef)((props
       paused: paused,
       playbackSpeed: playbackSpeed,
       decoder: webDecoder,
-      headers: uriSource?.headers,
-      cacheKey: uriSource?.cacheKey || cacheKey,
+      headers: dataSource ? undefined : uriSource?.headers,
+      cacheKey:
+      // As on Android and iOS, a data source's bytes are stored only when storage is set
+      dataSource && storage !== 'disk' && storage !== 'memory' ? undefined : uriSource?.cacheKey || cacheKey || (dataSource ? uriSource?.uri : undefined),
       storage: storage === 'disk' ? 'auto' : storage,
       maxStorageBytes: maxStorageBytes,
       style: fill,

package/lib/module/WebPlayer.web.js.map

@@ -1 +1 @@
-{"version":3,"names":["_react","_interopRequireWildcard","require","_reactNative","_react2","_AlphaVideoView","_jsxRuntime","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","toWebUrl","uri","startsWith","slice","length","replace","WebPlayer","exports","forwardRef","props","ref","source","autoPlay","loop","paused","playbackSpeed","webDecoder","cacheKey","storage","maxStorageBytes","style","onLoad","onError","onEnd","uriSource","isUriSource","undefined","src","jsx","View","styles","container","children","AlphaVideo","decoder","headers","fill","totalFrames","width","height","error","message","code","displayName","StyleSheet","create","overflow"],"sourceRoot":"../../react-native/src","sources":["WebPlayer.web.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_react","_interopRequireWildcard","require","_reactNative","_react2","_AlphaVideoView","_jsxRuntime","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","toWebUrl","uri","startsWith","slice","length","replace","registeredDataSource","name","scope","globalThis","Symbol","for","WebPlayer","exports","forwardRef","props","ref","source","autoPlay","loop","paused","playbackSpeed","webDecoder","cacheKey","storage","maxStorageBytes","style","onLoad","onError","onEnd","uriSource","isUriSource","undefined","dataSource","headersKey","JSON","stringify","headers","fromDataSource","useMemo","src","useEffect","error","jsx","View","styles","container","children","AlphaVideo","decoder","fill","totalFrames","width","height","message","code","displayName","StyleSheet","create","overflow"],"sourceRoot":"../../react-native/src","sources":["WebPlayer.web.tsx"],"mappings":";;;;;;AAMA,IAAAA,MAAA,GAAAC,uBAAA,CAAAC,OAAA;AACA,IAAAC,YAAA,GAAAD,OAAA;AACA,IAAAE,OAAA,GAAAF,OAAA;AAEA,IAAAG,eAAA,GAAAH,OAAA;AAAiG,IAAAI,WAAA,GAAAJ,OAAA;AAAA,SAAAD,wBAAAM,CAAA,EAAAC,CAAA,6BAAAC,OAAA,MAAAC,CAAA,OAAAD,OAAA,IAAAE,CAAA,OAAAF,OAAA,YAAAR,uBAAA,YAAAA,CAAAM,CAAA,EAAAC,CAAA,SAAAA,CAAA,IAAAD,CAAA,IAAAA,CAAA,CAAAK,UAAA,SAAAL,CAAA,MAAAM,CAAA,EAAAC,CAAA,EAAAC,CAAA,KAAAC,SAAA,QAAAC,OAAA,EAAAV,CAAA,iBAAAA,CAAA,uBAAAA,CAAA,yBAAAA,CAAA,SAAAQ,CAAA,MAAAF,CAAA,GAAAL,CAAA,GAAAG,CAAA,GAAAD,CAAA,QAAAG,CAAA,CAAAK,GAAA,CAAAX,CAAA,UAAAM,CAAA,CAAAM,GAAA,CAAAZ,CAAA,GAAAM,CAAA,CAAAO,GAAA,CAAAb,CAAA,EAAAQ,CAAA,gBAAAP,CAAA,IAAAD,CAAA,gBAAAC,CAAA,OAAAa,cAAA,CAAAC,IAAA,CAAAf,CAAA,EAAAC,CAAA,OAAAM,CAAA,IAAAD,CAAA,GAAAU,MAAA,CAAAC,cAAA,KAAAD,MAAA,CAAAE,wBAAA,CAAAlB,CAAA,EAAAC,CAAA,OAAAM,CAAA,CAAAK,GAAA,IAAAL,CAAA,CAAAM,GAAA,IAAAP,CAAA,CAAAE,CAAA,EAAAP,CAAA,EAAAM,CAAA,IAAAC,CAAA,CAAAP,CAAA,IAAAD,CAAA,CAAAC,CAAA,WAAAO,CAAA,KAAAR,CAAA,EAAAC,CAAA;AAVjG;AACA;AACA;AACA;AACA;;AAQA,8FACA,SAASkB,QAAQA,CAACC,GAAW,EAAU;EACrC,OAAOA,GAAG,CAACC,UAAU,CAAC,UAAU,CAAC,GAAG,GAAG,GAAGD,GAAG,CAACE,KAAK,CAAC,UAAU,CAACC,MAAM,CAAC,CAACC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAGJ,GAAG;AAClG;AAIA;AACA,SAASK,oBAAoBA,CAACC,IAAY,EAAiC;EACzE,MAAMC,KAAK,GAAGC,UAA2E;EACzF,OAAOD,KAAK,CAACE,MAAM,CAACC,GAAG,CAAC,0BAA0B,CAAC,CAAC,EAAElB,GAAG,CAACc,IAAI,CAAC;AACjE;AAEO,MAAMK,SAAS,GAAAC,OAAA,CAAAD,SAAA,gBAAG,IAAAE,iBAAU,EAAyC,CAACC,KAAK,EAAEC,GAAG,KAAK;EAC1F,MAAM;IAAEC,MAAM;IAAEC,QAAQ,GAAG,IAAI;IAAEC,IAAI,GAAG,IAAI;IAAEC,MAAM,GAAG,KAAK;IAAEC,aAAa,GAAG,CAAC;IAAEC,UAAU,GAAG,MAAM;IAAEC;EAAS,CAAC,GAAGR,KAAK;EACxH,MAAM;IAAES,OAAO;IAAEC;EAAgB,CAAC,GAAGV,KAAK;EAC1C,MAAM;IAAEW,KAAK;IAAEC,MAAM;IAAEC,OAAO;IAAEC;EAAM,CAAC,GAAGd,KAAK;EAC/C;EACA;EACA;EACA,MAAMe,SAAS,GAAG,IAAAC,2BAAW,EAACd,MAAM,CAAC,GAAGA,MAAM,GAAGe,SAAS;EAC1D,MAAMC,UAAU,GAAGH,SAAS,EAAEG,UAAU;EACxC,MAAMC,UAAU,GAAGC,IAAI,CAACC,SAAS,CAACN,SAAS,EAAEO,OAAO,IAAI,IAAI,CAAC;EAC7D,MAAMC,cAAc,GAAG,IAAAC,cAAO,EAC5B,MAAON,UAAU,IAAIH,SAAS,EAAE7B,GAAG,GAAGK,oBAAoB,CAAC2B,UAAU,CAAC,GAAGH,SAAS,CAAC7B,GAAG,EAAE;IAAEoC,OAAO,EAAEP,SAAS,CAACO;EAAQ,CAAC,CAAC,IAAI,IAAI,GAAG,IAAK;EACvI;EACA,CAACJ,UAAU,EAAEH,SAAS,EAAE7B,GAAG,EAAEiC,UAAU,CACzC,CAAC;EACD,MAAMM,GAAG,GAAGP,UAAU,GAAGK,cAAc,GAAG,IAAAP,2BAAW,EAACd,MAAM,CAAC,GAAIA,MAAM,CAAChB,GAAG,GAAGD,QAAQ,CAACiB,MAAM,CAAChB,GAAG,CAAC,GAAG+B,SAAS,GAAIf,MAAM;EAExH,IAAAwB,gBAAS,EAAC,MAAM;IACd,IAAIR,UAAU,IAAIH,SAAS,EAAE7B,GAAG,IAAI,CAACqC,cAAc,EAAE;MACnDV,OAAO,GAAG;QAAEc,KAAK,EAAE,kDAAkDT,UAAU;MAAI,CAAC,CAAC;IACvF;IACA;EACF,CAAC,EAAE,CAACK,cAAc,EAAEL,UAAU,EAAEH,SAAS,EAAE7B,GAAG,CAAC,CAAC;EAEhD,oBACE,IAAArB,WAAA,CAAA+D,GAAA,EAAClE,YAAA,CAAAmE,IAAI;IAAClB,KAAK,EAAE,CAACmB,MAAM,CAACC,SAAS,EAAEpB,KAAK,CAAE;IAAAqB,QAAA,EACpCP,GAAG,gBACF,IAAA5D,WAAA,CAAA+D,GAAA,EAACjE,OAAA,CAAAsE,UAAU;MACThC,GAAG,EAAEA,GAAI;MACTwB,GAAG,EAAEA,GAAI;MACTtB,QAAQ,EAAEA,QAAS;MACnBC,IAAI,EAAEA,IAAK;MACXC,MAAM,EAAEA,MAAO;MACfC,aAAa,EAAEA,aAAc;MAC7B4B,OAAO,EAAE3B,UAAW;MACpBe,OAAO,EAAEJ,UAAU,GAAGD,SAAS,GAAGF,SAAS,EAAEO,OAAQ;MACrDd,QAAQ;MACN;MACAU,UAAU,IAAIT,OAAO,KAAK,MAAM,IAAIA,OAAO,KAAK,QAAQ,GAAGQ,SAAS,GAAGF,SAAS,EAAEP,QAAQ,IAAIA,QAAQ,KAAKU,UAAU,GAAGH,SAAS,EAAE7B,GAAG,GAAG+B,SAAS,CACnJ;MACDR,OAAO,EAAEA,OAAO,KAAK,MAAM,GAAG,MAAM,GAAGA,OAAQ;MAC/CC,eAAe,EAAEA,eAAgB;MACjCC,KAAK,EAAEwB,IAAK;MACZvB,MAAM,EAAEA,CAAC;QAAEwB,WAAW;QAAEC,KAAK;QAAEC,MAAM;QAAEJ;MAAQ,CAAC,KAAKtB,MAAM,GAAG;QAAEwB,WAAW;QAAEC,KAAK;QAAEC,MAAM;QAAEJ;MAAQ,CAAC,CAAE;MACvGrB,OAAO,EAAGc,KAAK,IAAKd,OAAO,GAAG;QAAEc,KAAK,EAAEA,KAAK,CAACY,OAAO;QAAEC,IAAI,EAAEb,KAAK,CAACa;MAAK,CAAC,CAAE;MAC1E1B,KAAK,EAAEA,CAAA,KAAMA,KAAK,GAAG,CAAC,CAAC;IAAE,CAC1B,CAAC,GACA;EAAI,CACJ,CAAC;AAEX,CAAC,CAAC;AAEFjB,SAAS,CAAC4C,WAAW,GAAG,WAAW;AAEnC,MAAMX,MAAM,GAAGY,uBAAU,CAACC,MAAM,CAAC;EAC/BZ,SAAS,EAAE;IACTa,QAAQ,EAAE;EACZ;AACF,CAAC,CAAC;;AAEF;AACA,MAAMT,IAAyB,GAAG;EAAEE,KAAK,EAAE,MAAM;EAAEC,MAAM,EAAE;AAAO,CAAC","ignoreList":[]}

package/lib/typescript/react-native/src/AlphaVideoView.d.ts

@@ -31,9 +31,9 @@ export interface AlphaVideoSource {
     /** Sent with every request for the URL, e.g. Authorization; given to a `dataSource` too */
     headers?: Record<string, string>;
     /**
-     * iOS and Android: read the file through the data source the app registered under this name
-     * (`AlphaVideoDataSources.register` on Android, `AlphaVideoDataSources.register(_:name:)`
-     * on iOS) instead of the built-in fetcher.
+     * Read the file through the data source registered under this name instead of the built-in
+     * fetcher: range-source's `RangeDataSources` on Android and iOS, and range-source-web's on the
+     * web. MediaCache registers as `'mediacache'` with `cache.registerRangeDataSource()`.
      */
     dataSource?: string;
 }

package/lib/typescript/react-native/src/WebPlayer.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WebPlayer.web.d.ts","sourceRoot":"","sources":["../../../../react-native/src/WebPlayer.web.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAqB,MAAM,OAAO,CAAC;AAG1C,OAAO,EAAe,KAAK,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAOjG,eAAO,MAAM,SAAS,+FAgCpB,CAAC"}
+{"version":3,"file":"WebPlayer.web.d.ts","sourceRoot":"","sources":["../../../../react-native/src/WebPlayer.web.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAyC,MAAM,OAAO,CAAC;AAI9D,OAAO,EAAe,KAAK,mBAAmB,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAejG,eAAO,MAAM,SAAS,+FAkDpB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-alpha-video",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Transparent video for React Native: VP8, VP9 or AV1 WebM with alpha on iOS and Android, decoded by a C++ core (libvpx, dav1d for AV1) or the Android hardware decoder, drawn with Metal and OpenGL ES. On the web, alpha-video-web shows the alpha in every browser: <video>, WebCodecs or WebAssembly decoding.",
   "source": "react-native/src/index.tsx",
   "main": "lib/commonjs/index.js",
@@ -31,6 +31,8 @@
     "!android/*/build",
     "!android/*/.cxx",
     "!android/local.properties",
+    "!android/src/androidTest",
+    "!ios/Sources/AlphaVideoSource",
     "!react-native/android/build",
     "!react-native/android/.gradle",
     "!react-native/android/.cxx",
@@ -114,7 +116,7 @@
     "typescript": "^5.0.0"
   },
   "dependencies": {
-    "alpha-video-web": "^1.0.0"
+    "alpha-video-web": "^1.0.1"
   },
   "peerDependencies": {
     "react": "*",

package/react-native/android/build.gradle

@@ -47,7 +47,10 @@ if (isNewArchitectureEnabled()) {
     // levels up, in the package root.
     tasks.named('generateCodegenSchemaFromJavaScript').configure {
         jsRootDir.set(file("${packageRoot}/react-native/src"))
-        jsInputFiles.set(fileTree("${packageRoot}/react-native/src") { include '**/*.ts', '**/*.tsx' })
+        // A property in newer React Native; in 0.76 and earlier, a file tree that follows jsRootDir
+        if (jsInputFiles instanceof org.gradle.api.provider.Property) {
+            jsInputFiles.set(fileTree("${packageRoot}/react-native/src") { include '**/*.ts', '**/*.tsx' })
+        }
     }
     tasks.named('generateCodegenArtifactsFromSchema').configure {
         packageJsonFile.set(file("${packageRoot}/package.json"))

package/react-native/src/AlphaVideoView.tsx

@@ -41,9 +41,9 @@ export interface AlphaVideoSource {
   /** Sent with every request for the URL, e.g. Authorization; given to a `dataSource` too */
   headers?: Record<string, string>;
   /**
-   * iOS and Android: read the file through the data source the app registered under this name
-   * (`AlphaVideoDataSources.register` on Android, `AlphaVideoDataSources.register(_:name:)`
-   * on iOS) instead of the built-in fetcher.
+   * Read the file through the data source registered under this name instead of the built-in
+   * fetcher: range-source's `RangeDataSources` on Android and iOS, and range-source-web's on the
+   * web. MediaCache registers as `'mediacache'` with `cache.registerRangeDataSource()`.
    */
   dataSource?: string;
 }

package/react-native/src/WebPlayer.web.tsx

@@ -4,9 +4,10 @@
  * in WebGL2, loading those engines only when a file needs them.
  */
 
-import React, { forwardRef } from 'react';
+import React, { forwardRef, useEffect, useMemo } from 'react';
 import { View, StyleSheet } from 'react-native';
 import { AlphaVideo } from 'alpha-video-web/react';
+import type { ByteSource } from 'alpha-video-web';
 import { isUriSource, type AlphaVideoViewProps, type AlphaVideoViewRef } from './AlphaVideoView';
 
 /** asset://path names the app's bundled media; on the web it is served from the site root. */
@@ -14,14 +15,37 @@ function toWebUrl(uri: string): string {
   return uri.startsWith('asset://') ? '/' + uri.slice('asset://'.length).replace(/^\/+/, '') : uri;
 }
 
+type DataSourceFactory = (uri: string, init?: { headers?: Record<string, string> }) => ByteSource;
+
+/** range-source-web's `RangeDataSources`, read from its global symbol so this package needn't depend on it. */
+function registeredDataSource(name: string): DataSourceFactory | undefined {
+  const scope = globalThis as { [key: symbol]: Map<string, DataSourceFactory> | undefined };
+  return scope[Symbol.for('range-source.dataSources')]?.get(name);
+}
+
 export const WebPlayer = forwardRef<AlphaVideoViewRef, AlphaVideoViewProps>((props, ref) => {
   const { source, autoPlay = true, loop = true, paused = false, playbackSpeed = 1, webDecoder = 'auto', cacheKey } = props;
   const { storage, maxStorageBytes } = props;
   const { style, onLoad, onError, onEnd } = props;
   // Streamed by range from http(s) URLs and kept in the browser's storage (OPFS, else IndexedDB)
-  // by the canvas engines; <video> uses the HTTP cache. A Blob or byte source plays as it is.
+  // by the canvas engines; <video> uses the HTTP cache. A Blob or byte source plays as it is, and
+  // a `dataSource` name plays the byte source registered under it, which keeps the bytes itself.
   const uriSource = isUriSource(source) ? source : undefined;
-  const src = isUriSource(source) ? (source.uri ? toWebUrl(source.uri) : undefined) : source;
+  const dataSource = uriSource?.dataSource;
+  const headersKey = JSON.stringify(uriSource?.headers ?? null);
+  const fromDataSource = useMemo(
+    () => (dataSource && uriSource?.uri ? registeredDataSource(dataSource)?.(uriSource.uri, { headers: uriSource.headers }) ?? null : null),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [dataSource, uriSource?.uri, headersKey],
+  );
+  const src = dataSource ? fromDataSource : isUriSource(source) ? (source.uri ? toWebUrl(source.uri) : undefined) : source;
+
+  useEffect(() => {
+    if (dataSource && uriSource?.uri && !fromDataSource) {
+      onError?.({ error: `No data source is registered on the web under "${dataSource}"` });
+    }
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [fromDataSource, dataSource, uriSource?.uri]);
 
   return (
     <View style={[styles.container, style]}>
@@ -34,8 +58,11 @@ export const WebPlayer = forwardRef<AlphaVideoViewRef, AlphaVideoViewProps>((pro
           paused={paused}
           playbackSpeed={playbackSpeed}
           decoder={webDecoder}
-          headers={uriSource?.headers}
-          cacheKey={uriSource?.cacheKey || cacheKey}
+          headers={dataSource ? undefined : uriSource?.headers}
+          cacheKey={
+            // As on Android and iOS, a data source's bytes are stored only when storage is set
+            dataSource && storage !== 'disk' && storage !== 'memory' ? undefined : uriSource?.cacheKey || cacheKey || (dataSource ? uriSource?.uri : undefined)
+          }
           storage={storage === 'disk' ? 'auto' : storage}
           maxStorageBytes={maxStorageBytes}
           style={fill}