### Install react-native-video v7

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/updating

Install the next version of react-native-video to begin the upgrade process.

```bash
npm install react-native-video@next --save  

```

--------------------------------

### Install Chapters Package

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/video-view/chapters

Install the chapters package using npm. This is the first step to enable chapter functionality.

```bash
npm install @react-native-video/chapters  
```

--------------------------------

### Function: useVideoPlayer()

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/api-reference/functions/useVideoPlayer

Creates a VideoPlayer instance and manages its lifecycle. The setup function is called based on the initializeOnCreation flag.

```APIDOC
## Function: useVideoPlayer()

### Description
Creates a `VideoPlayer` instance and manages its lifecycle. if `initializeOnCreation` is true (default), the `setup` function will be called when the player is started loading source. if `initializeOnCreation` is false, the `setup` function will be called when the player is created. changes made to player made before initializing will be overwritten when initializing.

### Parameters
#### Path Parameters
- **source** (VideoSource | VideoConfig) - Required - The source of the video to play
- **setup?** (player) => void - Optional - A function to setup the player

### Returns
`VideoPlayer`
The `VideoPlayer` instance
```

--------------------------------

### Install Offline Video SDK Package

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player/downloading/getting-started

Install the Offline Video SDK package using npm.

```bash
npm install @TheWidlarzGroup/react-native-video-stream-downloader  
```

--------------------------------

### Install iOS Pods

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/updating

After updating the package, install the necessary pods for iOS.

```bash
cd ios && pod install  

```

--------------------------------

### Initialize useVideoPlayer with a configuration object

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player/use-video-player

Provide a configuration object to useVideoPlayer for more control over the player's setup, including the video source URI.

```javascript
const player = useVideoPlayer({
  source: {
    uri: 'https://www.w3schools.com/html/mov_bbb.mp4',
  },
});
```

--------------------------------

### Deferred Initialization with useVideoPlayer

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player/video-player

To defer player initialization, set `initializeOnCreation` to false. You can then manually initialize the player later, for example, in response to a user interaction. Listeners can be attached during the deferred initialization setup.

```javascript
const player = useVideoPlayer({
    source: { uri: 'https://example.com/video.mp4' },
    initializeOnCreation: false,
}, (instance) => {
    // Attach listeners first
    instance.onLoad = () => console.log('Loaded');
});

// Later (e.g. on user tap)
await player.initialize(); // or player.preload()
player.play();

```

--------------------------------

### v7 Video Player Implementation with Hooks

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/updating

Example of a video player component using the new v7 implementation with the useVideoPlayer hook and VideoView.

```javascript
import React from 'react';
import { useVideoPlayer, VideoView, useEvent } from 'react-native-video';

const VideoPlayerV7 = () => {
  const player = useVideoPlayer({
    source: {
      uri: 'https://www.w3schools.com/html/mov_bbb.mp4',
    },
  });

  useEvent(player, 'onLoad', () => {
    console.log('Video loaded');
  });

  useEvent(player, 'onProgress', (data) => {
    console.log('Progress:', data.currentTime);
  });

  return (
    <VideoView
      player={player}
      style={{ width: 300, height: 200 }}
      controls={true}
    />
  );
};

```

--------------------------------

### Configure and Run with React Native CLI

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/fundamentals/installation

For React Native CLI projects, install iOS pods by navigating to the 'ios' directory and running 'pod install'. Then, run the project on iOS or Android using 'npx react-native run-ios' or 'npx react-native run-android'.

```bash
cd ios && pod install && cd ..  
```

```bash
npx react-native run-ios # run on iOS  
```

```bash
npx react-native run-android # run on Android  
```

--------------------------------

### Create and Manage VideoPlayer Instance

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/api-reference/functions/useVideoPlayer

Use this hook to create a VideoPlayer instance. The setup function is called on initialization, and changes made before initialization will be overwritten.

```typescript
function useVideoPlayer(source, setup?): VideoPlayer;
```

--------------------------------

### Deferred Initialization with initialize()

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player/video-player

Use `initialize()` when you have deferred player creation and need to explicitly create and attach the native player item or media source. This method prepares the player without starting playback.

```javascript
player.initialize()
```

--------------------------------

### Interface: onLoadStartData

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/api-reference/interfaces/onLoadStartData

The onLoadStartData interface provides information about the video source and its type when the video playback starts.

```APIDOC
## Interface: onLoadStartData

### Description
Provides information about the video source and its type when playback is about to start.

### Properties

#### source
- **source** (VideoPlayerSourceBase) - The source object of the video.
  Defined in: types/Events.ts:187

#### sourceType
- **sourceType** (SourceType) - The type of the video source.
  Defined in: types/Events.ts:183
  
  Note: `local` for local files, `network` for network sources.
```

--------------------------------

### Install React Native Video Dependencies

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/fundamentals/installation

Use npm to install the necessary packages for React Native Video and its dependencies. Ensure you are using the '@next' tag for v7.

```bash
npm install react-native-video@next react-native-nitro-modules  
```

--------------------------------

### Basic Plugin Template for Android

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/plugins/examples

Implement a basic plugin for Android by extending ReactNativeVideoPlugin. This example shows how to hook into player creation and destruction, and override video sources.

```kotlin
class MyPlugin : ReactNativeVideoPlugin("MyPlugin") {
    override fun onPlayerCreated(player: WeakReference<NativeVideoPlayer>) {
        Log.d("MyPlugin", "Player created with uri ${player.get()?.source.uri}")
    }
      
    override fun onPlayerDestroyed(player: WeakReference<NativeVideoPlayer>) {
        Log.d("MyPlugin", "Player destroyed")
    }
      
    override fun overrideSource(source: NativeVideoPlayerSource): NativeVideoPlayerSource {
        Log.d("MyPlugin", "Overriding source with uri ${source.uri}")
        return source
    }
}
  
// Usage  
val plugin = MyPlugin() // Automatically registered  

```

--------------------------------

### Basic Plugin Template for iOS

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/plugins/examples

Implement a basic plugin for iOS by extending ReactNativeVideoPlugin. This example demonstrates custom logic for player creation and destruction, and source overriding.

```swift
class MyPlugin: ReactNativeVideoPlugin {
    init() {
        super.init(name: "MyPlugin")
    }
      
    override func onPlayerCreated(player: Weak<NativeVideoPlayer>) {
        // Custom logic when player is created
    }
      
    override func onPlayerDestroyed(player: Weak<NativeVideoPlayer>) {
        // Custom cleanup when player is destroyed
    }
      
    override func overrideSource(source: NativeVideoPlayerSource) async -> NativeVideoPlayerSource {
        // Modify source if needed
        return source
    }
}
  
// Usage
let plugin = MyPlugin() // Automatically registered

```

--------------------------------

### Get Current Download Configuration

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player/downloading

Retrieves the current global configuration settings for downloads.

```javascript
import { getConfig } from "@TheWidlarzGroup/react-native-video-stream-downloader";

const config = getConfig();

```

--------------------------------

### Example: Multi-Language Track Selection

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player/downloading/track-selection

Demonstrates selecting multiple audio and subtitle tracks for different languages, along with the primary video track, for a comprehensive download. This requires filtering available tracks by language.

```javascript
import { getAvailableTracks, downloadStream } from "@TheWidlarzGroup/react-native-video-stream-downloader";  
  
const tracks = await getAvailableTracks(videoUrl);  
  
// Select video track (highest quality)  
const videoTrack = tracks.video[0];  
  
// Select multiple audio tracks (English and Spanish)  
const audioTracks = tracks.audio.filter(t =>   
  t.language === "en" || t.language === "es"  
);  
  
// Select subtitles for both languages  
const subtitleTracks = tracks.text.filter(t =>   
  t.language === "en" || t.language === "es"  
);  
  
// Build track selection array  
const selectedTracks = [  
  { id: videoTrack.id, type: "video" as const },  
  ...audioTracks.map(t => ({ id: t.id, type: "audio" as const })),  
  ...subtitleTracks.map(t => ({ id: t.id, type: "text" as const })),  
];  
  
await downloadStream(videoUrl, {  
  tracks: selectedTracks,  
});  
```

--------------------------------

### Preloading Media with preload()

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player/video-player

Call `preload()` to prepare the player item and start buffering content ahead of an upcoming `play()` call. This ensures the media source is set and buffering is initiated.

```javascript
player.preload()
```

--------------------------------

### Android-Specific Registry Methods Signatures

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/plugins/registry

Provides example signatures for Android-specific methods to customize ExoPlayer sources, media items, and caching behavior.

```kotlin
internal fun overrideMediaDataSourceFactory(
    source: NativeVideoPlayerSource,
    mediaDataSourceFactory: DataSource.Factory
): DataSource.Factory

internal fun overrideMediaSourceFactory(
    source: NativeVideoPlayerSource,
    mediaSourceFactory: MediaSource.Factory,
    mediaDataSourceFactory: DataSource.Factory
): MediaSource.Factory

internal fun overrideMediaItemBuilder(
    source: NativeVideoPlayerSource,
    mediaItemBuilder: MediaItem.Builder
): MediaItem.Builder

internal fun shouldDisableCache(source: NativeVideoPlayerSource): Boolean
```

--------------------------------

### v6 Video Player Implementation

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/updating

Example of a video player component using the v6 implementation of react-native-video.

```javascript
import React, { useRef } from 'react';
import Video from 'react-native-video';

const VideoPlayerV6 = () => {
  const videoRef = useRef(null);

  return (
    <Video
      source={{ uri: 'https://www.w3schools.com/html/mov_bbb.mp4' }}
      ref={videoRef}
      style={{ width: 300, height: 200 }}
      controls={true}
      onLoad={() => console.log('Video loaded')}
      onProgress={(data) => console.log('Progress:', data.currentTime)}
    />
  );
};

```

--------------------------------

### Configure and Run with Expo

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/fundamentals/installation

After installing dependencies, use 'npx expo prebuild' to generate native files for Expo projects. Then, run the project on iOS or Android using 'npx expo run:ios' or 'npx expo run:android'.

```bash
npx expo prebuild  
```

```bash
npx expo run:ios # run on iOS  
```

```bash
npx expo run:android # run on Android  
```

--------------------------------

### Register Offline Video SDK Plugin

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player/downloading/getting-started

After installation, authorize the plugin with your API key. Replace YOUR_API_KEY with the actual key obtained from sdk.thewidlarzgroup.com.

```javascript
import { registerPlugin } from "@TheWidlarzGroup/react-native-video-stream-downloader";  
  
const success = await registerPlugin("YOUR_API_KEY");  
```

--------------------------------

### Configure Video Buffering

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player/use-video-player

Use `bufferConfig` within `VideoConfig` to set buffering parameters for Android, iOS, and live playback. This example shows how to configure minimum and maximum buffer durations for Android, preferred forward buffer duration for iOS, and a target live offset.

```javascript
const player = useVideoPlayer({
  source: {
    uri: 'https://example.com/stream.m3u8',
    bufferConfig: {
      // Android
      minBufferMs: 5000,
      maxBufferMs: 10000,
      // iOS
      preferredForwardBufferDurationMs: 3000,
      // Live (cross‑platform target)
      livePlayback: { targetOffsetMs: 500 },
    },
  },
});

```

--------------------------------

### v6 Event Handling Example

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/updating

This snippet shows the event handling mechanism used in v6 of react-native-video.

```javascript
<Video  
  onLoad={(data) => console.log(data)}  
  onProgress={(data) => console.log(data.currentTime)}  
  onError={(error) => console.error(error)}  
/>  

```

--------------------------------

### iOS Plugin Example - React Native Video

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/plugins

Create a custom plugin for iOS by subclassing ReactNativeVideoPlugin and implementing the init method to set a unique name. Override methods like onPlayerCreated to add custom logic.

```swift
class MyPlugin: ReactNativeVideoPlugin {
    init() {
        super.init(name: "MyPluginName")
    }

    override func onPlayerCreated(player: Weak<NativeVideoPlayer>) {
        // Custom logic here
    }
}
```

--------------------------------

### Basic useVideoPlayer Hook Usage

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player/video-player

Use this hook in functional components to manage the VideoPlayer lifecycle. It automatically creates and cleans up the player instance. The optional setup function allows for immediate configuration after creation.

```javascript
import { useVideoPlayer } from 'react-native-video';  
  
const MyComponent = () => {  
  const player = useVideoPlayer('https://example.com/video.mp4', (playerInstance) => {  
    // Optional setup function: configure the player instance after creation  
    playerInstance.loop = true;  
  });  
  
  // ... use player ...  
  
  return <VideoView player={player} />;  
};  

```

--------------------------------

### Android Plugin Example - React Native Video

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/plugins

Implement a custom plugin for Android by extending ReactNativeVideoPlugin and overriding methods like onPlayerCreated. Ensure to provide a unique plugin name during instantiation.

```kotlin
class MyPlugin : ReactNativeVideoPlugin("MyPluginName") {
    override fun onPlayerCreated(player: WeakReference<NativeVideoPlayer>) {
        // Custom logic here
    }
}
```

--------------------------------

### Get DRM Manager (iOS)

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/plugins/registry

Asynchronously finds the first registered plugin that can provide a DRM manager for the given source on iOS. Throws `LibraryError.DRMPluginNotFound` if no plugin is found.

```swift
internal func getDrmManager(source: NativeVideoPlayerSource) async throws -> Any? {
    for plugin in plugins.values {
        if let drmManager = await plugin.getDRMManager(source: source) {
            return drmManager
        }
    }
    throw LibraryError.DRMPluginNotFound.error()
}
```

--------------------------------

### Get DRM Manager (Android)

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/plugins/registry

Finds the first registered plugin that can provide a DRM manager for the given source on Android. Throws `LibraryError.DRMPluginNotFound` if no plugin is found.

```kotlin
internal fun getDRMManager(source: NativeVideoPlayerSource): Any {
    for (plugin in plugins.values) {
        val manager = plugin.getDRMManager(source)
        if (manager != null) return manager
    }
    throw LibraryError.DRMPluginNotFound
}
```

--------------------------------

### Throttle Progress Events for Analytics

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player/analytics/simple

Implement throttling for the `onProgress` event to avoid excessive tracking calls. This example tracks video progress every 10 seconds, including session and video metadata. Requires `uuid` and `useRef` for session management.

```javascript
const sessionId = useRef(uuid()).current;  
  
const handleProgress = (data) => {  
  // Throttle to every 10 seconds  
  if (Math.floor(data.currentTime) % 10 === 0) {  
    analytics.track('video_progress', {  
      sessionId,  
      videoId: 'video-123',  
      currentTime: data.currentTime,  
    });  
  }  
};  
```

--------------------------------

### Initialization Methods

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player/video-player

Comparison of different methods for initializing the video player.

```APIDOC
## Initialization Methods Comparison

### `initialize()`

- **When to use**: You deferred initialization and now want to create the native player item / media source.
- **What it does**: Creates & attaches the underlying player item / media source without starting playback.

### `preload()`

- **When to use**: You want the player item prepared (buffering kicked off) ahead of an upcoming `play()` call.
- **What it does**: Ensures the media source is set and prepared; resolves once preparation started (may already be initialized).

### Implicit (default)

- **When to use**: `initializeOnCreation` not set or `true`.
- **What it does**: Automatically schedules initialization after JS construction.

**Info**: By default, the player initializes automatically after construction. If you need to defer initialization, set `initializeOnCreation: false` in the config. You can then call `player.initialize()` or `player.preload()` later to start the player.
```

--------------------------------

### Get Available Audio Tracks - WebVideoPlayer

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/api-reference/interfaces/WebVideoPlayer

Use this method to retrieve available audio tracks for the video player. This functionality is specific to web environments and relies on the WebVideoPlayer interface. Browser support for audio tracks is limited, and this method may return an empty array.

```typescript
import { useVideoPlayer, type WebVideoPlayer } from 'react-native-video';  
  
const player = useVideoPlayer(source) as WebVideoPlayer;  
const audioTracks = player.getAvailableAudioTracks();  
```

--------------------------------

### VideoPlayer Initialization

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player/video-player

Demonstrates how to initialize the VideoPlayer class with different source configurations.

```APIDOC
## VideoPlayer Initialization

To use the `VideoPlayer`, you first need to create an instance of it with a video source. By default the native media item is initialized asynchronously right after creation (unless you opt out with `initializeOnCreation: false`).

```javascript
import { VideoPlayer } from 'react-native-video';  
  
// Using a URL string  
const player = new VideoPlayer('https://example.com/video.mp4');  
  
// Using a VideoSource object  
const playerWithSource = new VideoPlayer({ uri: 'https://example.com/video.mp4' });  
  
// Using a VideoConfig object  
const playerWithConfig = new VideoPlayer({  
  source: { uri: 'https://example.com/video.mp4' },  
  // other configurations  
});  
```

**Warning:** When using `VideoPlayer` class directly, you need to manually manage the player lifecycle. Once you no longer need the player, you need to call `release()` method to release the player's native resources. See the Player Lifecycle section below for more details.
```

--------------------------------

### Initialization Timing and Events

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player/events

Explains how `onLoadStart` and `onLoad` events behave based on the `initializeOnCreation` setting and when to attach event handlers.

```APIDOC
### Initialization Timing and Events

`onLoadStart` / `onLoad` will fire automatically after construction when `initializeOnCreation` (default `true`) is enabled. If you set `initializeOnCreation: false`, these events will not fire until you call `initialize()` or `preload()`. Attach your event handlers before invoking those methods to avoid missing early events.
```

--------------------------------

### Install DRM Plugin Dependency

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player/drm

Install the DRM plugin package using npm. This plugin provides DRM support for React Native Video.

```bash
npm install @react-native-video/drm
```

--------------------------------

### Get Video Duration

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/api-reference/classes/VideoPlayer

Retrieves the total duration of the video in seconds. Returns NaN if the duration is not available.

```typescript
get duration(): number;
```

--------------------------------

### Initialize useVideoPlayer with a video source

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player/use-video-player

Use this hook to create and manage a VideoPlayer instance. Pass a video source URL directly for simple initialization.

```javascript
import { useVideoPlayer } from 'react-native-video';

const player = useVideoPlayer('https://www.w3schools.com/html/mov_bbb.mp4');
```

--------------------------------

### VideoRuntimeError get message() Signature

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/api-reference/interfaces/VideoRuntimeError

Retrieves the error message for the video runtime error. Inherited from VideoError.

```typescript
get message(): string;
```

--------------------------------

### Instantiate Video Player

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player/video-player

Create a `VideoPlayer` instance by passing a video source URL directly to the constructor. The native player is allocated immediately.

```javascript
const player = new VideoPlayer('https://example.com/video.mp4');

```

--------------------------------

### Player Lifecycle and Initialization

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player/video-player

Understanding the player's lifecycle, from creation and default initialization to advanced deferred initialization.

```APIDOC
## Player Lifecycle

Understanding the lifecycle of the `VideoPlayer` is crucial for managing resources effectively and ensuring a smooth user experience.

### Creation and Initialization

  1. **Instantiation** : A `VideoPlayer` instance is created by calling its constructor with a video source (URL, `VideoSource`, or `VideoConfig`).

```javascript
const player = new VideoPlayer('https://example.com/video.mp4');
```

  2. **Native Player Allocation** : A lightweight native player object is allocated immediately.
  3. **Asset Initialization** : By default (unless you opt out) the underlying media item is prepared **asynchronously right after creation**. You can control this with `initializeOnCreation` inside `VideoConfig`.

#### Deferred Initialization (Advanced)

If you pass a `VideoConfig` with `{ initializeOnCreation: false }`, the player will skip preparing the media item automatically. This is useful when:
  * You need to batch‑create many players without incurring immediate decoding / network cost
  * You want to attach event handlers before any network requests happen
  * You want explicit control over when buffering begins (e.g. on user interaction)

To initialize later, call:

```javascript
await player.initialize();
// or preload if you also want it prepared & ready
await player.preload();
```

```

--------------------------------

### Get All Download Statuses

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player/downloading

Fetches the status for all downloads managed by the downloader, including those that are active, queued, completed, or failed.

```typescript
import { getDownloadsStatus } from "@TheWidlarzGroup/react-native-video-stream-downloader";

const allStatuses = await getDownloadsStatus();
```

--------------------------------

### VideoRuntimeError get stack() Signature

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/api-reference/interfaces/VideoRuntimeError

Retrieves the stack trace for the video runtime error, if available. Inherited from VideoError.

```typescript
get stack(): string | undefined;
```

--------------------------------

### VideoRuntimeError get code() Signature

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/api-reference/interfaces/VideoRuntimeError

Retrieves the error code associated with the video runtime error. Inherited from VideoError.

```typescript
get code(): TCode;
```

--------------------------------

### Import and Use VideoPlayer in JavaScript

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/plugins/use-in-third-party-library

Import the VideoPlayer component from 'react-native-video' and instantiate it with a video URI. Ensure the library is installed as a dependency.

```javascript
import { VideoPlayer } from 'react-native-video';

const player = new VideoPlayer({ uri: 'https://www.example.com/video.mp4' });

player.play();
```

--------------------------------

### Basic DRM Configuration for Downloading

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player/downloading/drm-downloading

Use this basic configuration to download DRM-protected content. Ensure your license server supports persistent licenses and provide an authorization token if required.

```javascript
import { downloadStream } from "@TheWidlarzGroup/react-native-video-stream-downloader";  

await downloadStream(videoUrl, {
  drm: {
    licenseServer: "https://license.example.com/acquire",
    headers: {
      "Authorization": "Bearer YOUR_TOKEN",
    },
  },
});
```

--------------------------------

### Get Current Video Time

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/api-reference/classes/VideoPlayer

Retrieves the current playback time of the video in seconds. Returns NaN if the duration is not yet available.

```typescript
get currentTime(): number;
```

--------------------------------

### Initialize VideoPlayer Instance

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player/video-player

Create an instance of VideoPlayer with a video source. The native media item is initialized asynchronously by default. You can initialize using a URL string, a VideoSource object, or a VideoConfig object.

```javascript
import { VideoPlayer } from 'react-native-video';  

// Using a URL string  
const player = new VideoPlayer('https://example.com/video.mp4');  

// Using a VideoSource object  
const playerWithSource = new VideoPlayer({ uri: 'https://example.com/video.mp4' });  

// Using a VideoConfig object  
const playerWithConfig = new VideoPlayer({  
  source: { uri: 'https://example.com/video.mp4' },  
  // other configurations  
});  
```

--------------------------------

### v7 Event Handling with useEvent Hook

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/updating

Demonstrates the recommended event handling approach in v7 using the `useEvent` hook, which automatically manages listener cleanup. Ensure `useVideoPlayer`, `VideoView`, and `useEvent` are imported.

```javascript
import { useVideoPlayer, VideoView, useEvent } from 'react-native-video';  
  
const MyPlayer = () => {  
  const player = useVideoPlayer({ source: { uri: '...' } });  
  
  useEvent(player, 'onLoad', (data) => console.log(data));  
  useEvent(player, 'onProgress', (data) => console.log(data.currentTime));  
  useEvent(player, 'onError', (error) => console.error(error.code, error.message));  
  
  return <VideoView player={player} />;  
}  

```

--------------------------------

### Get Specific Download Status

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player/downloading

Retrieve the current status of a single download using its unique identifier. Returns null if the download ID is not found.

```typescript
import { getDownloadStatus } from "@TheWidlarzGroup/react-native-video-stream-downloader";

const status = await getDownloadStatus(downloadId);
```

--------------------------------

### Basic VideoView Usage

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/video-view

Use VideoView by passing a VideoPlayer instance to its `player` prop. Ensure the player is initialized and optionally configured before rendering.

```javascript
import React from 'react';
import { VideoPlayer, VideoView } from 'react-native-video';
import { StyleSheet } from 'react-native';

const App = () => {
  const player = useVideoPlayer('https://example.com/video.mp4', (_player) => {
    // This is optional setup function that will be called when the player is created.
    _player.play();
  });

  return (
    <VideoView
      style={styles.video}
      player={player}
      controls={true}
    />
  );
};

const styles = StyleSheet.create({
  video: {
    width: '100%',
    height: 200,
  },
});

export default App;
```

--------------------------------

### Initialize Video Player Manually

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player/video-player

For deferred initialization, call `player.initialize()` or `player.preload()` after creating the `VideoPlayer` instance with `initializeOnCreation: false` in `VideoConfig`.

```javascript
await player.initialize();
// or preload if you also want it prepared & ready
await player.preload();

```

--------------------------------

### iOS Get DRM Manager

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/plugins/interface

Provide a custom DRM manager for protected content on iOS. Return null if this plugin does not handle DRM for the given source.

```swift
func getDRMManager(source: NativeVideoPlayerSource) async -> Any?
```

--------------------------------

### Enter Fullscreen Mode

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/api-reference/interfaces/VideoViewRef

Initiates fullscreen mode for the video player. This method does not take any arguments.

```typescript
enterFullscreen: () => void;
```

--------------------------------

### Android Get DRM Manager

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/plugins/interface

Provide a custom DRM manager for protected content on Android. Return null if this plugin does not handle DRM for the given source.

```kotlin
fun getDRMManager(source: NativeVideoPlayerSource): Any?
```

--------------------------------

### onLoadStart Event

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/api-reference/interfaces/VideoPlayerEvents

Called when the video begins loading. This event precedes onLoad.

```typescript
onLoadStart: (data) => void;
```

--------------------------------

### Enable DRM Plugin

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player/drm

Enable the DRM plugin at your application's startup before creating any video players. This ensures DRM functionalities are available.

```typescript
import { enable } from '@react-native-video/drm';

enable();
```

--------------------------------

### Using TextureView for UI Effects

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/video-view/props

Use TextureView when UI effects like rounded corners or animations are needed. This example demonstrates applying styles and enabling controls with TextureView.

```javascript
<VideoView  
  player={player}  
  surfaceType="texture"  
  style={{ width: 300, height: 170, borderRadius: 16, overflow: 'hidden' }}  
  resizeMode="cover"  
  controls  
/>  
```

--------------------------------

### Get Available Tracks for Video Stream

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player/downloading/track-selection

Use `getAvailableTracks` to retrieve all available audio, video, and text tracks from a video stream URL. This is the first step in selective track downloading.

```javascript
import { getAvailableTracks } from "@TheWidlarzGroup/react-native-video-stream-downloader";  
  
const tracks = await getAvailableTracks("https://example.com/video.m3u8");  
// tracks.video, tracks.audio, tracks.text contain available tracks  
```

--------------------------------

### Configuration Management

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player/downloading

APIs for setting and retrieving global download configurations.

```APIDOC
## POST /setConfig

### Description
Sets global configuration for downloads.

### Method
POST

### Endpoint
/setConfig

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
- **config** (object) - Required - Configuration with the following properties:
  - **updateFrequencyMS** (number) - Optional - How often to update download progress (in milliseconds)
  - **maxParallelDownloads** (number) - Optional - Maximum number of simultaneous downloads

### Request Example
```json
{
  "updateFrequencyMS": 1000,
  "maxParallelDownloads": 3
}
```

### Response
#### Success Response (200)
None

#### Response Example
None
```

```APIDOC
## GET /getConfig

### Description
Gets the current global configuration.

### Method
GET

### Endpoint
/getConfig

### Parameters
None

### Request Example
None

### Response
#### Success Response (200)
- **config** (object) - Current global configuration with properties:
  - **updateFrequencyMS** (number) - Optional
  - **maxParallelDownloads** (number) - Optional

#### Response Example
```json
{
  "updateFrequencyMS": 1000,
  "maxParallelDownloads": 3
}
```
```

--------------------------------

### Configure ExoPlayer Extensions (Android)

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/fundamentals/configuration/without-expo

Configure ExoPlayer extensions in gradle.properties to enable or disable DASH and HLS playback support. Set properties to 'false' to exclude extensions and reduce APK size.

```properties
# Enable / disable ExoPlayer extensions used by react-native-video
RNVideo_useExoplayerDash=true   # DASH playback support
RNVideo_useExoplayerHls=true    # HLS  playback support
```

--------------------------------

### Get Available Tracks from Stream URL

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player/downloading

Inspects a video stream URL to retrieve details about available video, audio, and subtitle tracks. This information can be used to select specific tracks for download.

```typescript
import { getAvailableTracks } from "@TheWidlarzGroup/react-native-video-stream-downloader";

const tracks = await getAvailableTracks("https://example.com/video.m3u8");

// Use tracks.video, tracks.audio, tracks.text to let user select
// Then pass selected tracks to downloadStream
```

--------------------------------

### VideoPlayer Constructor

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/api-reference/classes/VideoPlayer

Initializes a new instance of the VideoPlayer class.

```APIDOC
## Constructor VideoPlayer

### Description
Initializes a new instance of the VideoPlayer class.

### Method
`new`

### Parameters
#### Path Parameters
- **source** (VideoSource | VideoConfig | VideoPlayerSource) - Required - The source configuration for the video player.

### Returns
`VideoPlayer` - An instance of the VideoPlayer.

### Overrides
`VideoPlayerEvents.constructor`
```

--------------------------------

### Basic Video Player Usage on Web

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/fundamentals/web-support

Use the standard `useVideoPlayer` and `VideoView` components for video playback on the web. Ensure your video source is a URL.

```javascript
import { useVideoPlayer, VideoView } from 'react-native-video';  
  
function Player() {  
  const player = useVideoPlayer({  
    uri: 'https://example.com/video.mp4',  
  });  
  
  return (  
    <VideoView  
      player={player}  
      controls  
      style={{ width: '100%', aspectRatio: 16 / 9 }}  
    />  
  );  
}  

```

--------------------------------

### Android Get Media Data Source Factory

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/plugins/interface

Override the data source factory used by ExoPlayer on Android. Return null to use the default factory. Useful for custom caching or network optimization.

```kotlin
fun getMediaDataSourceFactory(
    source: NativeVideoPlayerSource,
    mediaDataSourceFactory: DataSource.Factory
): DataSource.Factory?
```

--------------------------------

### Configure FairPlay DRM on iOS (Default Flow)

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player/drm

Set up FairPlay DRM on iOS using the default license flow. `certificateUrl` and `licenseUrl` are required. `source.headers` are used for the license request, not `drm.licenseHeaders`.

```javascript
useVideoPlayer({
  source: {
    uri: 'https://example.com/fairplay.m3u8',
    headers: { Authorization: 'Bearer <token>' }, // used for the license request
    drm: {
      // type: 'fairplay', // optional
      certificateUrl: 'https://license.example.com/fps-cert',
      licenseUrl: 'https://license.example.com/fps',
      // contentId: 'my-content-id', // optional
    },
  },
});

```

--------------------------------

### VideoView Ref Usage

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/video-view/methods

Demonstrates how to obtain a ref to the VideoView component and call its imperative methods.

```APIDOC
## Using VideoViewRef

### Description
Obtain a ref to the `VideoView` component to call imperative methods for controlling video playback.

### Method
`React.useRef` and component ref assignment

### Endpoint
N/A (Client-side component interaction)

### Request Example
```javascript
const videoViewRef = React.useRef<VideoViewRef>(null);

// ...

<VideoView ref={videoViewRef} player={player} />

// Later, you can call methods like:
videoViewRef.current?.enterFullscreen();
```

### Available Methods on `VideoViewRef`

#### `enterFullscreen()`
- **Type**: `() => void`
- **Description**: Programmatically requests the video view to enter fullscreen mode.

#### `exitFullscreen()`
- **Type**: `() => void`
- **Description**: Programmatically requests the video view to exit fullscreen mode.

#### `enterPictureInPicture()`
- **Type**: `() => void`
- **Description**: Programmatically requests the video view to enter picture-in-picture mode.

#### `exitPictureInPicture()`
- **Type**: `() => void`
- **Description**: Programmatically requests the video view to exit picture-in-picture mode.

#### `canEnterPictureInPicture()`
- **Type**: `() => boolean`
- **Description**: Checks if picture-in-picture mode is currently available and supported. Returns `true` if PiP can be entered, `false` otherwise.
```

--------------------------------

### Enter Picture-in-Picture Mode

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/api-reference/interfaces/VideoViewRef

Initiates picture-in-picture mode for the video player. This method does not take any arguments.

```typescript
enterPictureInPicture: () => void;
```

--------------------------------

### Configuration API

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player/downloading

APIs for setting and retrieving download configurations.

```APIDOC
## Configuration API

### Description
APIs for managing the download configuration.

### Methods

#### `setConfig(config: DownloadConfig): void`
Sets the download configuration.

#### `getConfig(): DownloadConfig`
Retrieves the current download configuration.
```

--------------------------------

### Using the useEvent Hook

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player/downloading/events-downloading

The `useEvent` hook allows you to subscribe to download events. It automatically manages cleanup when the component unmounts.

```APIDOC
## Using Events

Events are automatically typed and can be used with the `useEvent` hook:

```javascript
import { useEvent } from "@TheWidlarzGroup/react-native-video-stream-downloader";

function DownloadManager() {
  useEvent("onDownloadProgress", (downloads) => {
    // Update UI with progress
  });

  useEvent("onDownloadEnd", (download) => {
    // Handle completion
  });

  useEvent("onError", (error) => {
    // Handle errors
  });

  // ... rest of component
}
```

The `useEvent` hook automatically manages cleanup when the component unmounts, preventing memory leaks.
```

--------------------------------

### Set Video Chapters with Options

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/video-view/chapters

Define and set video chapters using the setChapters function. You can customize marker colors, and tooltip/timer visibility. Ensure chapters are defined with title and timeMs in milliseconds.

```javascript
import { setChapters } from '@react-native-video/chapters';  
  
const chapters = [  
  { title: "Introduction", timeMs: 0 },  
  { title: "Main Content", timeMs: 30000 }, // 30 seconds  
  { title: "Conclusion", timeMs: 120000 },  // 2 minutes  
];  
  
setChapters(chapters, {  
  markersColor: "#FF6B35",  
  showTooltip: true,  
  showTimer: true,  
});  
```

--------------------------------

### ReactNativeVideoPlugin Base Implementation

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/plugins/interface

Details the base implementation provided by `ReactNativeVideoPlugin`, including automatic registration, cleanup, and default method implementations.

```APIDOC
## Base Implementation: ReactNativeVideoPlugin

The base class provides default implementations for all methods.

### Automatic Registration
```kotlin
// Android
init {
    PluginsRegistry.shared.register(this)
}
```

```swift
// iOS
public init(name: String) {
    self.name = name
    self.id = "RNV_Plugin_".appending(name)
    PluginsRegistry.shared.register(plugin: self)
}
```

### Automatic Cleanup (iOS only)
```swift
deinit {
    PluginsRegistry.shared.unregister(plugin: self)
}
```

### Default Implementations
All methods have sensible defaults:
  * Lifecycle methods: No-op implementations
  * `overrideSource`: Returns the original source unchanged
  * `getDRMManager`: Returns `null`
  * Factory methods (Android): Return `null` (use defaults)
  * `shouldDisableCache`: Returns `false`
```

--------------------------------

### DRM Integration

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player/video-player

Information on how to integrate DRM for protected content using a plugin and passing DRM configuration.

```APIDOC
## DRM

Protected content is supported via a plugin. See the full DRM guide: DRM.

Quick notes:
  * Install and enable the official plugin `@react-native-video/drm` and call `enable()` at app startup before creating players.
  * Pass DRM configuration on the source using the `drm` property of `VideoConfig` (see the DRM guide for platform specifics and `getLicense` examples).
  * If you defer initialization (`initializeOnCreation: false`), be sure to call `await player.initialize()` (or `preload()`) before expecting DRM license acquisition events.

```

--------------------------------

### VideoPlayer Constructor

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/api-reference/classes/VideoPlayer

Initializes a new VideoPlayer instance. Accepts various source types including VideoSource, VideoConfig, or VideoPlayerSource.

```typescript
new VideoPlayer(source): VideoPlayer;
```

--------------------------------

### Resource Management API

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/api-reference/classes/VideoPlayer

Methods for initializing, releasing, and replacing video sources.

```APIDOC
## initialize()

### Description
Manually initializes the video player. This is typically handled automatically unless `initializeOnCreation` is set to `false` in the `VideoConfig`.

### Method
`initialize(): Promise<void>;`

### Returns
`Promise<void>`

## release()

### Description
Releases the native resources and state associated with the player. The player becomes unusable after this method is called. Use `replaceSourceAsync` with `null` to clean player resources instead.

### Method
`release(): void;`

### Returns
`void`

## replaceSourceAsync(source: VideoSource | VideoConfig | null)

### Description
Replaces the current video source with a new one. Passing `null` will clear the current source.

### Method
`replaceSourceAsync(source): Promise<void>;`

### Parameters
#### Path Parameters
- **source** (VideoSource | VideoConfig | null) - Required - The new video source or configuration, or null to clear the source.

### Returns
`Promise<void>`
```

--------------------------------

### Register Plugin (iOS)

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/plugins/interface

Initialize and register the plugin with the PluginsRegistry on iOS. Requires a name for the plugin.

```swift
// iOS
public init(name: String) {
    self.name = name
    self.id = "RNV_Plugin_\(name)"
    PluginsRegistry.shared.register(plugin: self)
}

```

--------------------------------

### Video Source Configuration

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/api-reference/type-aliases/VideoConfig

Specify the video source using a URI string or a require statement for local assets.

```typescript
uri: 'https://example.com/video.mp4'
```

```typescript
uri: require('./assets/video.mp4')
```

--------------------------------

### Initialize Video Player with useVideoPlayer Hook

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player

Use the useVideoPlayer hook for most use cases. It automatically manages the player lifecycle between component mount and unmount. Requires importing the hook from 'react-native-video'.

```javascript
import { useVideoPlayer } from 'react-native-video';  
  
const player = useVideoPlayer({
  source: {
    uri: 'https://www.w3schools.com/html/mov_bbb.mp4',
  },
});
```

--------------------------------

### selectAudioTrack()

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/api-reference/interfaces/WebVideoPlayer

Selects an audio track for playback. This is an experimental feature.

```APIDOC
## POST /selectAudioTrack

### Description
Select an audio track.

### Method
POST

### Endpoint
/selectAudioTrack

### Parameters
#### Request Body
- **track** (AudioTrack | null) - Required - The audio track to select, or null to deselect.

### Request Example
```json
{
  "track": "track_id_or_null"
}
```

### Response
#### Success Response (200)
- **void** (void) - This method does not return a value.

#### Response Example
```json
{
  "message": "Audio track selection successful"
}
```
```

--------------------------------

### Android Player Creation Callback

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/plugins/interface

Called on Android when a new player instance is created. Use this to initialize player-specific resources or set up listeners.

```kotlin
@UnstableApi
fun onPlayerCreated(player: WeakReference<NativeVideoPlayer>)
```

--------------------------------

### VideoViewProps Interface

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/api-reference/interfaces/VideoViewProps

This section details the properties available for configuring the VideoView component.

```APIDOC
## Interface: VideoViewProps

Defined in: video-view/VideoViewProps.ts:8

## Extends
  * `Partial<VideoViewEvents>`.
  * `ViewProps`

### Properties

#### autoEnterPictureInPicture? (boolean)

* Optional
* Description: Whether to automatically enter picture in picture mode when the video is playing. Defaults to false.
* Defined in: video-view/VideoViewProps.ts:28

#### controls? (boolean)

* Optional
* Description: Whether to show the controls. Defaults to false.
* Defined in: video-view/VideoViewProps.ts:20

#### keepScreenAwake? (boolean)

* Optional
* Description: Whether to keep the screen awake while the video view is mounted. Defaults to true.
* Defined in: video-view/VideoViewProps.ts:40

#### onFullscreenChange? ((fullscreen) => void)

* Optional
* Description: Called when the video view's fullscreen state changes.
* Parameters:
    * `fullscreen` (boolean) - Whether the video view is in fullscreen mode.
* Returns: `void`
* Inherited from: `VideoViewEvents`.`onFullscreenChange`
* Defined in: types/Events.ts:116

#### onPictureInPictureChange? ((isInPictureInPicture) => void)

* Optional
* Description: Called when the video view's picture in picture state changes.
* Parameters:
    * `isInPictureInPicture` (boolean) - Whether the video view is in picture in picture mode.
* Returns: `void`
* Inherited from: `VideoViewEvents`.`onPictureInPictureChange`
* Defined in: types/Events.ts:111

#### pictureInPicture? (boolean)

* Optional
* Description: Whether to enable & show the picture in picture button in native controls. Defaults to false.
* Defined in: video-view/VideoViewProps.ts:24

#### player (VideoPlayerBase)

* Required
* Description: The player to play the video
* Defined in: video-view/VideoViewProps.ts:12

#### resizeMode? (ResizeMode)

* Optional
* Description: How the video should be resized to fit the view. Defaults to 'none'.
  * 'contain': Scale the video uniformly (maintain aspect ratio) so that it fits entirely within the view
  * 'cover': Scale the video uniformly (maintain aspect ratio) so that it fills the entire view (may crop)
  * 'stretch': Scale the video to fill the entire view without maintaining aspect ratio
  * 'none': Do not resize the video
* Defined in: video-view/VideoViewProps.ts:36

#### style? (ViewStyle)

* Optional
* Description: The style of the video view - ViewStyle
* Overrides: `ViewProps.style`
* Defined in: video-view/VideoViewProps.ts:16

#### surfaceType? (SurfaceType)

* Optional
* Description: The type of underlying native view. Defaults to 'surface'.
  * 'surface': Uses a SurfaceView on Android. More performant, but cannot be animated or transformed.
  * 'texture': Uses a TextureView on Android. Less performant, but can be animated and transformed.
* Platform: android
* Default: 'surface'
* Defined in: video-view/VideoViewProps.ts:52

#### willEnterFullscreen? (() => void)

* Optional
* Description: Called when the video view will enter fullscreen mode.
* Returns: `void`
* Inherited from: `VideoViewEvents`.`willEnterFullscreen`
* Defined in: types/Events.ts:120

#### willEnterPictureInPicture? (() => void)

* Optional
* Description: Called when the video view will enter picture in picture mode.
* Returns: `void`
* Inherited from: `VideoViewEvents`.`willEnterPictureInPicture`
* Defined in: types/Events.ts:128

#### willExitFullscreen? (() => void)

* Optional
* Description: Called when the video view will exit fullscreen mode.
* Returns: `void`
* Inherited from: `VideoViewEvents`.`willExitFullscreen`
* Defined in: types/Events.ts:124

#### willExitPictureInPicture? (() => void)

* Optional
* Description: Called when the video view will exit picture in picture mode.
* Returns: `void`
* Inherited from: `VideoViewEvents`.`willExitPictureInPicture`
* Defined in: types/Events.ts:132
```

--------------------------------

### Initialize Video Player with Class Constructor

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player

Initialize the VideoPlayer class directly. When using the class constructor, you must manually manage the player lifecycle by calling `release()` when done. Requires importing VideoPlayer from 'react-native-video'.

```javascript
import { VideoPlayer } from 'react-native-video';  
  
// Using a URL string  
const player = new VideoPlayer('https://example.com/video.mp4');  
  
// Using a VideoSource object  
const playerWithSource = new VideoPlayer({ uri: 'https://example.com/video.mp4' });  
  
// Using a VideoConfig object  
const playerWithConfig = new VideoPlayer({  
  source: { uri: 'https://example.com/video.mp4' },  
  // other configurations  
});
```

--------------------------------

### Android Configuration for Offline Video SDK

Source: https://docs.thewidlarzgroup.com/react-native-video/docs/v7/player/downloading/getting-started

Add this line to your ./android/app/build.gradle file within the dependencies block. Ensure the path correctly points to your project's node_modules location.

```gradle
implementation fileTree(dir: "../../node_modules/@TheWidlarzGroup/react-native-video-stream-downloader/native-libs", include: ["*.aar"])  
```