This feature is available exclusively in Pro Player. To access this functionality, please contact us.
Getting Started
This section covers the Offline Video SDK - a commercial extension for react-native-video that enables downloading and offline playback.
The Offline Video SDK is a commercial add-on for react-native-video (versions 6 and 7) that enables secure offline playback of HLS/DASH streams or static videos like MP4, including support for DRM, multiple audio tracks, and subtitles.
Requirements
- React Native Video: version 6.15.0 or higher (versions 6 and 7 are supported)
- iOS: 15.0 or higher
- Android: 6.0 or higher
- Api key: A valid api key for the Offline Video SDK is required. You can obtain this through the SDK platform.
Features
- HLS/DASH/MP4 Downloading: Download and store video streams for offline playback
- Asset Management: Full control over downloaded assets
- Offline DRM: Supports offline playback of DRM-protected content with proper rights enforcement and license handling
- Offline Playback: Play downloaded content without internet connection
- Cross-platform: Works on both iOS and Android
Installation
1. Configure npm for Private Package
Since this is a private package, configure npm to access GitHub Packages by adding the following to your ~/.npmrc file:
@TheWidlarzGroup:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=<NPM_GITHUB_AUTH_TOKEN>
Replace <NPM_GITHUB_AUTH_TOKEN> with your GitHub token. To obtain this token, please contact us.
This token is different from the API key used for plugin authorization.
2. Install the Package
Install the package using npm:
npm install @TheWidlarzGroup/react-native-video-stream-downloader
3. Android Configuration
Add the following line to your ./android/app/build.gradle file in the dependencies block:
implementation fileTree(dir: "../../node_modules/@TheWidlarzGroup/react-native-video-stream-downloader/native-libs", include: ["*.aar"])
Ensure the path matches your project's node_modules location.
4. iOS Configuration
No additional configuration is required for iOS; the plugin will be automatically linked.
5. Plugin Authorization
After installation, authorize the plugin with an API key:
import { registerPlugin } from "@TheWidlarzGroup/react-native-video-stream-downloader";
const success = await registerPlugin("YOUR_API_KEY");
Replace "YOUR_API_KEY" with your actual API key obtained from sdk.thewidlarzgroup.com.
Supported Formats
| Format | iOS | Android |
|---|---|---|
| HLS | ✅ | ✅ |
| MP4 | ✅ | ✅ |
| MPEG-DASH | ❌ | ✅ |
Licensing & Pricing
The Offline Video SDK is distributed under a commercial license. You can evaluate it for free for 14 days without a credit card. For questions or assistance, contact hi@thewidlarzgroup.com.