react-native-tpstreams 0.1.7 → 0.1.9

package/LICENSE

@@ -1,20 +1,20 @@
-MIT License
-
-Copyright (c) 2025 Bharath
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2025 Bharath
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,49 +1,427 @@
-# react-native-tpstreams
-
-Video Component for TPStreams
-
-## Installation
-
-```sh
-npm install react-native-tpstreams
-```
-
-## Usage
-
-
-```js
-import React, { useState } from 'react';
-import { NativeModules } from 'react-native';
-import TpStreamsPlayerView from 'react-native-tpstreams';
-
-const { Tpstreams } = NativeModules;
-
-// Initialize the player with your organization UUID
-Tpstreams.initializeTPSPlayer("ORGANIZATION_ID");
-
-const App = () => {
-  const [playerProps, setPlayerProps] = useState({
-    videoId: 'ASSET_ID',
-    accessToken: 'ACCESS_TOKEN',
-    style: { width: '100%', height: 300 },
-  });
-
-  return <TpStreamsPlayerView {...playerProps} />;
-};
-
-export default App;
-
-```
-
-
-## Contributing
-
-See the [contributing guide](CONTRIBUTING.md) to learn how to contribute to the repository and the development workflow.
-
-## License
-
-MIT
-
----
-
-Made with [create-react-native-library](https://github.com/callstack/react-native-builder-bob)
+# react-native-tpstreams
+
+Video Component for TPStreams
+
+## Installation
+
+```sh
+npm install react-native-tpstreams
+```
+
+### Initializing TPStreams SDK
+
+First, import the package:
+
+```javascript
+import { NativeModules } from 'react-native';
+const { Tpstreams } = NativeModules;
+```
+
+Next, initialize the SDK with your organization ID:
+
+```javascript
+Tpstreams.initializeTPSPlayer("YOUR_ORGANIZATION_ID");
+```
+
+Make sure to replace `YOUR_ORGANIZATION_ID` with your actual organization ID. This should be called at the entry point of your application to ensure proper initialization.
+
+## Play a Video
+
+To play a video using the TPStreams Player SDK, use the `TpStreamsPlayerView` component:
+
+```javascript
+import React, { useState } from 'react';
+import { View, StyleSheet } from 'react-native';
+import TpStreamsPlayerView from 'react-native-tpstreams';
+
+const App = () => {
+  const [playerProps] = useState({
+    videoId: 'ASSET_ID',
+    accessToken: 'ACCESS_TOKEN',
+    enableDownload: false,
+    autoPlay: true,
+    style: { width: '100%', height: 300 },
+  });
+
+  return (
+    <View style={styles.container}>
+      <TpStreamsPlayerView {...playerProps} />
+    </View>
+  );
+};
+
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+    justifyContent: 'center',
+    alignItems: 'center',
+  },
+});
+
+export default App;
+```
+
+Replace `ASSET_ID` and `ACCESS_TOKEN` with the actual assetId and accessToken of the video you wish to play.
+
+## Player Props
+The player component accepts the following props:
+
+| Prop            | Type    | Required | Default                         | Description                                    |
+|----------------|---------|----------|---------------------------------|------------------------------------------------|
+| `videoId`      | string  | Yes      | -                               | The unique identifier of the video asset.      |
+| `accessToken`  | string  | Yes      | -                               | The authentication token required to access the video. |
+| `enableDownload` | boolean | No     | `true`                          | Enables or disables video download.           |
+| `autoPlay`     | boolean | No      | `true`                          | Controls whether the video should start playing automatically. |
+| `style`        | object  | No      | `{ width: '100%', height: 300 }` | Defines the player’s width and height.        |
+
+# Player Methods
+
+To use the `Tpstreams` module, first import `NativeModules` from `react-native` and get the `Tpstreams` instance:
+
+```js
+import { NativeModules } from 'react-native';
+const { Tpstreams } = NativeModules;
+```
+
+The `Tpstreams` module provides several methods to control video playback and manage player states. Below is a detailed explanation of each method:
+
+## Play
+
+```js
+Tpstreams.play();
+```
+
+Starts video playback. Call this method when you want the video to start playing or resume after being paused.
+
+## Pause
+
+```js
+Tpstreams.pause();
+```
+
+Pauses video playback, allowing it to be resumed later from the same position.
+
+## Seek To
+
+```js
+Tpstreams.seekTo(position: number);
+```
+
+Seeks to a specific position in the video (in milliseconds).
+
+**Example Usage:**
+
+```js
+Tpstreams.seekTo(10000); // Jump to the 10-second mark
+```
+
+## Get Current Time
+
+```js
+Tpstreams.getCurrentTime().then(console.log);
+```
+
+Gets the current playback position of the video (in milliseconds). Returns a promise that resolves with the current time.
+
+## Get Duration
+
+```js
+Tpstreams.getDuration().then(console.log);
+```
+
+Retrieves the total duration of the currently loaded video (in milliseconds). Returns a promise that resolves with the total duration.
+
+## Get Buffered Time
+
+```js
+Tpstreams.getBufferedTime().then(console.log);
+```
+
+Gets the amount of video data that has been buffered (in milliseconds). Returns a promise that resolves with the buffered time.
+
+## Get Playback State
+
+```js
+Tpstreams.getPlaybackState().then(console.log);
+```
+
+Gets the current playback state of the player (e.g., `playing`, `paused`, `buffering`). Returns a promise that resolves with the state.
+
+## Get Play When Ready
+
+```js
+Tpstreams.getPlayWhenReady().then(console.log);
+```
+
+Checks if the player is set to start playback automatically. Returns a promise that resolves with a boolean value.
+
+## Set Play When Ready
+
+```js
+Tpstreams.setPlayWhenReady(true); // Enable autoplay
+```
+
+Controls whether the player should start playback automatically when loaded.
+
+## Get Playback Speed
+
+```js
+Tpstreams.getPlaybackSpeed().then(console.log);
+```
+
+Gets the current playback speed of the video. Returns a promise that resolves with the speed value.
+
+## Set Playback Speed
+
+```js
+Tpstreams.setPlaybackSpeed(1.5); // Play at 1.5x speed
+```
+
+Changes the playback speed of the video.
+
+## Release
+
+```js
+Tpstreams.release();
+```
+
+Releases the player resources, stopping playback and hiding the player UI. Once called, the player cannot be used again unless reinitialized.
+
+
+# Player Events
+
+`Tpstreams` provides event listeners to handle various player events. Below are the available events and how to use them:
+
+## Listening to Events
+
+To subscribe to player events, use the `NativeEventEmitter` from `react-native` with `TpstreamsModule`:
+
+```js
+import { NativeEventEmitter, NativeModules } from 'react-native';
+
+const { Tpstreams } = NativeModules;
+const eventEmitter = new NativeEventEmitter(Tpstreams);
+
+const subscription = eventEmitter.addListener('onPlaybackStateChanged', (state) => {
+  console.log('Playback State Changed:', state);
+});
+
+// Remember to remove the listener when unmounting
+subscription.remove();
+```
+
+## Available Events
+
+### onPlaybackStateChanged
+Triggered when the playback state changes.
+
+```js
+eventEmitter.addListener('onPlaybackStateChanged', (state) => {
+  console.log('Playback State:', state);
+});
+```
+
+### onAccessTokenExpired
+Triggered when the access token expires (requires refresh).
+
+```js
+eventEmitter.addListener('onAccessTokenExpired', () => {
+  console.log('Access token expired, please refresh.');
+});
+```
+
+### onMarkerCallback
+Triggered when a marker (timestamp) is reached during playback.
+
+```js
+eventEmitter.addListener('onMarkerCallback', (marker) => {
+  console.log('Marker reached:', marker);
+});
+```
+
+### onDeviceInfoChanged
+Triggered when the device information changes.
+
+```js
+eventEmitter.addListener('onDeviceInfoChanged', (info) => {
+  console.log('Device info changed:', info);
+});
+```
+
+### onFullScreenChanged
+Triggered when the fullscreen mode changes.
+
+```js
+eventEmitter.addListener('onFullScreenChanged', (isFullscreen) => {
+  console.log('Fullscreen mode:', isFullscreen);
+});
+```
+
+### onIsLoadingChanged
+Triggered when the player’s loading state changes.
+
+```js
+eventEmitter.addListener('onIsLoadingChanged', (isLoading) => {
+  console.log('Loading state changed:', isLoading);
+});
+```
+
+### onIsPlayingChanged
+Triggered when the player’s playing state changes.
+
+```js
+eventEmitter.addListener('onIsPlayingChanged', (isPlaying) => {
+  console.log('Playing state:', isPlaying);
+});
+```
+
+### onPlayerError
+Triggered when the player encounters an error.
+
+```js
+eventEmitter.addListener('onPlayerError', (error) => {
+  console.log('Player Error:', error);
+});
+```
+
+### onSeekBackIncrementChanged
+Triggered when the seek-back increment value changes.
+
+```js
+eventEmitter.addListener('onSeekBackIncrementChanged', (value) => {
+  console.log('Seek back increment changed:', value);
+});
+```
+
+### onSeekForwardIncrementChanged
+Triggered when the seek-forward increment value changes.
+
+```js
+eventEmitter.addListener('onSeekForwardIncrementChanged', (value) => {
+  console.log('Seek forward increment changed:', value);
+});
+```
+
+### onTimelineChanged
+Triggered when the timeline of the player changes.
+
+```js
+eventEmitter.addListener('onTimelineChanged', (timeline) => {
+  console.log('Timeline changed:', timeline);
+});
+```
+
+### onTracksChanged
+Triggered when the available tracks change (e.g., audio/video/subtitles).
+
+```js
+eventEmitter.addListener('onTracksChanged', (tracks) => {
+  console.log('Tracks changed:', tracks);
+});
+```
+
+# Download Module
+
+The `Download Module` in `Tpstreams` allows users to manage offline video downloads efficiently. This includes observing download progress, pausing, resuming, canceling, and deleting downloads.
+
+## Observing Download Data
+
+To start observing the download data, call the `observeDownloadData` method from `FragmentModule`.
+
+```js
+import { NativeModules, DeviceEventEmitter } from 'react-native';
+
+const { FragmentModule } = NativeModules;
+FragmentModule.observeDownloadData();
+```
+
+Once initialized, the module will emit events whenever the download data changes.
+
+## Listening to Download Events
+
+To listen for download state changes, use `DeviceEventEmitter`:
+
+```js
+const subscription = DeviceEventEmitter.addListener(
+  'onDownloadDataChanged',
+  (event) => {
+    console.log('Download data updated:', event.assets);
+  }
+);
+
+// Remember to remove the listener when unmounting
+subscription.remove();
+```
+
+## Managing Downloads
+
+### Pause Download
+Pauses an active download.
+
+```js
+FragmentModule.pauseDownload(videoId);
+```
+
+### Resume Download
+Resumes a paused download.
+
+```js
+FragmentModule.resumeDownload(videoId);
+```
+
+### Cancel Download
+Cancels an ongoing download.
+
+```js
+FragmentModule.cancelDownload(videoId);
+```
+
+### Delete Download
+Deletes a completed download from storage.
+
+```js
+FragmentModule.deleteDownload(videoId);
+```
+
+## Rendering a Download List
+
+Below is a sample implementation of a download list UI using `FlatList` in React Native:
+
+```js
+import React, { useState, useEffect } from 'react';
+import { SafeAreaView, Text, FlatList, View, Button, DeviceEventEmitter } from 'react-native';
+import { NativeModules } from 'react-native';
+
+const { FragmentModule } = NativeModules;
+
+const DownloadListScreen = () => {
+  const [downloads, setDownloads] = useState([]);
+
+  useEffect(() => {
+    FragmentModule.observeDownloadData();
+    const subscription = DeviceEventEmitter.addListener('onDownloadDataChanged', (event) => {
+      setDownloads(event.assets);
+    });
+    return () => subscription.remove();
+  }, []);
+
+  const renderItem = ({ item }) => (
+    <View>
+      <Text>{item.title} - {item.percentage}%</Text>
+      {item.status === 'DOWNLOADING' && <Button title="Pause" onPress={() => FragmentModule.pauseDownload(item.videoId)} />}
+      {item.status === 'COMPLETE' && <Button title="Delete" onPress={() => FragmentModule.deleteDownload(item.videoId)} />}
+      {item.status === 'PAUSED' && <Button title="Resume" onPress={() => FragmentModule.resumeDownload(item.videoId)} />}
+    </View>
+  );
+
+  return (
+    <SafeAreaView>
+      <FlatList data={downloads} keyExtractor={(item) => item.videoId} renderItem={renderItem} />
+    </SafeAreaView>
+  );
+};
+
+export default DownloadListScreen;
+```
+
+This component observes download events and dynamically updates the list with buttons for user interactions.

package/Tpstreams.podspec

@@ -1,42 +1,42 @@
-require "json"
-
-package = JSON.parse(File.read(File.join(__dir__, "package.json")))
-folly_compiler_flags = '-DFOLLY_NO_CONFIG -DFOLLY_MOBILE=1 -DFOLLY_USE_LIBCPP=1 -Wno-comma -Wno-shorten-64-to-32'
-
-Pod::Spec.new do |s|
-  s.name         = "Tpstreams"
-  s.version      = package["version"]
-  s.summary      = package["description"]
-  s.homepage     = package["homepage"]
-  s.license      = package["license"]
-  s.authors      = package["author"]
-
-  s.platforms    = { :ios => min_ios_version_supported }
-  s.source       = { :git => "https://github.com/testpress/react-native-player-sdk.git", :tag => "#{s.version}" }
-
-  s.source_files = "ios/**/*.{h,m,mm,cpp}"
-  s.private_header_files = "ios/generated/**/*.h"
-
-  # Use install_modules_dependencies helper to install the dependencies if React Native version >=0.71.0.
-  # See https://github.com/facebook/react-native/blob/febf6b7f33fdb4904669f99d795eba4c0f95d7bf/scripts/cocoapods/new_architecture.rb#L79.
-  if respond_to?(:install_modules_dependencies, true)
-    install_modules_dependencies(s)
-  else
-    s.dependency "React-Core"
-
-    # Don't install the dependencies when we run `pod install` in the old architecture.
-    if ENV['RCT_NEW_ARCH_ENABLED'] == '1' then
-      s.compiler_flags = folly_compiler_flags + " -DRCT_NEW_ARCH_ENABLED=1"
-      s.pod_target_xcconfig    = {
-          "HEADER_SEARCH_PATHS" => "\"$(PODS_ROOT)/boost\"",
-          "OTHER_CPLUSPLUSFLAGS" => "-DFOLLY_NO_CONFIG -DFOLLY_MOBILE=1 -DFOLLY_USE_LIBCPP=1",
-          "CLANG_CXX_LANGUAGE_STANDARD" => "c++17"
-      }
-      s.dependency "React-Codegen"
-      s.dependency "RCT-Folly"
-      s.dependency "RCTRequired"
-      s.dependency "RCTTypeSafety"
-      s.dependency "ReactCommon/turbomodule/core"
-    end
-  end
-end
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+folly_compiler_flags = '-DFOLLY_NO_CONFIG -DFOLLY_MOBILE=1 -DFOLLY_USE_LIBCPP=1 -Wno-comma -Wno-shorten-64-to-32'
+
+Pod::Spec.new do |s|
+  s.name         = "Tpstreams"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => min_ios_version_supported }
+  s.source       = { :git => "https://github.com/testpress/react-native-player-sdk.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,cpp}"
+  s.private_header_files = "ios/generated/**/*.h"
+
+  # Use install_modules_dependencies helper to install the dependencies if React Native version >=0.71.0.
+  # See https://github.com/facebook/react-native/blob/febf6b7f33fdb4904669f99d795eba4c0f95d7bf/scripts/cocoapods/new_architecture.rb#L79.
+  if respond_to?(:install_modules_dependencies, true)
+    install_modules_dependencies(s)
+  else
+    s.dependency "React-Core"
+
+    # Don't install the dependencies when we run `pod install` in the old architecture.
+    if ENV['RCT_NEW_ARCH_ENABLED'] == '1' then
+      s.compiler_flags = folly_compiler_flags + " -DRCT_NEW_ARCH_ENABLED=1"
+      s.pod_target_xcconfig    = {
+          "HEADER_SEARCH_PATHS" => "\"$(PODS_ROOT)/boost\"",
+          "OTHER_CPLUSPLUSFLAGS" => "-DFOLLY_NO_CONFIG -DFOLLY_MOBILE=1 -DFOLLY_USE_LIBCPP=1",
+          "CLANG_CXX_LANGUAGE_STANDARD" => "c++17"
+      }
+      s.dependency "React-Codegen"
+      s.dependency "RCT-Folly"
+      s.dependency "RCTRequired"
+      s.dependency "RCTTypeSafety"
+      s.dependency "ReactCommon/turbomodule/core"
+    end
+  end
+end