tirtc-react-native 2.3.1 → 2.4.0-alpha.4

package/README.md

@@ -1,14 +1,16 @@
 # TiRTC React Native SDK
 
-`tirtc-react-native` is the TiRTC React Native New Architecture package for Android and iOS.
+`tirtc-react-native` is the TiRTC and Ti Cloud Storage React Native New Architecture package for Android and iOS.
 
 ```sh
 npm install tirtc-react-native
 ```
 
-The package ships ESM JavaScript, TypeScript declarations, Codegen specs, Android native wrapper code and iOS native wrapper code. It requires React Native `>=0.80.0`, Android `com.tange.ai:tirtc:2.3.1`, and iOS `TiRTC` `2.3.1` with iOS minimum `15.1`.
+The package ships ESM JavaScript, TypeScript declarations, Codegen specs, Android native wrapper code and iOS native wrapper code. RTC and CloudStorage use the same native Runtime delivery but keep separate initialization and resource lifecycles. The package requires React Native `>=0.80.0`, Android `com.tange.ai:tirtc:2.4.0-alpha.4`, and iOS `TiRTC` `2.4.0-alpha.4` with iOS minimum `15.1`.
 
-Version `2.3.1` is a stable React Native release aligned with the TiRTC 2.3.1 Android and Darwin SDKs.
+The iOS package supports arm64 devices and Apple Silicon iOS Simulator. Simulator validation covers build, launch, connection, downlink audio, and downlink video; capture and iOS behavioral qualification remain real-device gates.
+
+Version `2.4.0-alpha.4` is an alpha React Native release aligned with the TiRTC 2.4.0-alpha.4 Android and Darwin SDKs.
 
 ## Imports
 
@@ -54,7 +56,7 @@ The SDK reports platform failures through numeric TiRTC return codes and callbac
 import React from 'react';
 import {TiRtc, TiRtcConn, TiRtcVideoOutput, TiRtcVideoOutputView} from 'tirtc-react-native';
 
-await TiRtc.initialize({appId, endpoint});
+await TiRtc.init({appId, endpoint});
 
 const conn = new TiRtcConn();
 const videoOutput = new TiRtcVideoOutput();
@@ -73,6 +75,8 @@ export function RemoteVideo() {
 }
 ```
 
+`TiRtc.initialize(...)` remains available as a deprecated forwarding alias to `TiRtc.init(...)`.
+
 Dispose in reverse ownership order:
 
 ```ts
@@ -115,15 +119,27 @@ export function LocalPreview() {
 }
 ```
 
+## Saving Temporary Media
+
+RTC recordings, RTC snapshots, CloudStorage recordings, and CloudStorage snapshots return temporary cache file objects. Publish one to the Android or iOS system media library with an optional final filename:
+
+```ts
+const result = await file.moveToGallery(
+  '客厅角落摄像头-2026-08-20-14-30-05-123.mp4',
+);
+```
+
+The package does not declare or request gallery permissions. The application must prepare Android or iOS authorization before calling this method. Omit the filename to use an epoch-millisecond name; a missing `.mp4` or `.jpg` extension is appended automatically. Invalid names resolve with code `6000` without invoking the native module or deleting the cache source. A successful move deletes the source and returns an opaque `content://` or `ph://` URI; a failed move keeps the source available for retry.
+
 ## Errors And Lifecycle
 
 Public methods return numeric TiRTC codes instead of throwing for SDK failures. `0` means success. Use `TiRtc.errorToString(code)` or `TiRtc.formatError(code)` for display and logs.
 
-Constructors create native owner identities, so outputs and inputs can attach to a `TiRtcConn` before `connect(...)`. `dispose()` releases the native object only after the underlying stop/destroy call returns success. Calling `dispose()` again after success is valid and returns success; methods called after a successful dispose return the object released code. Input/output/view ownership is tracked by native object id plus generation so stale callbacks or recycled ids do not attach to a newer object.
+Constructors create native owner identities, so outputs and inputs can attach to a `TiRtcConn` before `connect(...)`. `dispose()` releases the native object only after the underlying stop/destroy call returns success. Calling `dispose()` again after success is valid and returns success; methods called after a successful dispose return the not-initialized code. Input/output/view ownership is tracked by native object id plus generation so stale callbacks or recycled ids do not attach to a newer object.
 
 ## Release
 
-Version `2.3.1` is the current React Native package for TiRTC client media output and talkback. It supports React Native New Architecture apps on Android and iOS and pins Android `com.tange.ai:tirtc:2.3.1` and iOS `TiRTC` `2.3.1`.
+Version `2.4.0-alpha.4` is the current React Native package for TiRTC client media output and talkback. It supports React Native New Architecture apps on Android and iOS and pins Android `com.tange.ai:tirtc:2.4.0-alpha.4` and iOS `TiRTC` `2.4.0-alpha.4`.
 
 ## License
 
@@ -143,7 +159,7 @@ The external application sample is published under `react-native/` in
 `tirtc-api-samples`. The owner-local projection and recovery entry is:
 
 ```sh
-./scripts/publish_api_samples.sh --version 2.3.1
+./scripts/publish_api_samples.sh --version 2.4.0-alpha.4
 ```
 
 Use `--no-push` for a complete local projection/build rehearsal without writing

package/TiRtcReactNative.podspec

@@ -13,7 +13,7 @@ Pod::Spec.new do |s|
   s.source = { :git => 'https://gitlab.tange-ai.com/tirtc-nexus/tirtc.git', :tag => s.version.to_s }
   s.source_files = 'ios/**/*.{h,m,mm,swift}'
   s.dependency 'React-Core'
-  s.dependency 'TiRTC', '2.3.1'
+  s.dependency 'TiRTC', '2.4.0-alpha.4'
 
   if respond_to?(:install_modules_dependencies, true)
     install_modules_dependencies(s)

package/android/build.gradle

@@ -29,7 +29,7 @@ repositories {
 
 dependencies {
   implementation "com.facebook.react:react-android"
-  implementation "com.tange.ai:tirtc:${safeExtGet("tirtcAndroidVersion", "2.3.1")}"
+  implementation "com.tange.ai:tirtc:${safeExtGet("tirtcAndroidVersion", "2.4.0-alpha.4")}"
 }
 
 def safeExtGet(prop, fallback) {

package/android/src/main/AndroidManifest.xml

@@ -1 +1,2 @@
-<manifest xmlns:android="http://schemas.android.com/apk/res/android" />
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>