omikit-plugin 3.3.5 → 3.3.7

package/README.md

@@ -125,6 +125,17 @@ You can refer <a href="https://github.com/VIHATTeam/OMICALL-React-Native-SDK/blo
       <uses-permission android:name="com.google.android.c2dm.permission.RECEIVE" />
       <uses-permission android:name="android.permission.WAKE_LOCK" />
       <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
+      
+      <!-- 🔥 Android 15+ (SDK 35+) Required Permissions -->
+      <uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>
+      <uses-permission android:name="android.permission.RECORD_AUDIO"/>
+      <uses-permission android:name="android.permission.CALL_PHONE"/>
+      <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/>
+      <uses-permission android:name="android.permission.USE_SIP"/>
+      <uses-permission android:name="android.permission.FOREGROUND_SERVICE_MICROPHONE"/>
+      <uses-permission android:name="android.permission.FOREGROUND_SERVICE_PHONE_CALL"/>
+      <uses-permission android:name="android.permission.CAMERA"/> <!-- For video calls -->
+      
       // ... your config
 
          <application
@@ -568,6 +579,62 @@ We support 2 environments. So you need set correct key in Appdelegate.
 
 ```
 
+### 🔥 **Android 15+ Permission Management**
+
+**📌 For Android 15+ (SDK 35+), additional permissions are required:**
+
+```xml
+<!-- Required in AndroidManifest.xml -->
+<uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>
+<uses-permission android:name="android.permission.FOREGROUND_SERVICE_MICROPHONE"/>
+<uses-permission android:name="android.permission.FOREGROUND_SERVICE_PHONE_CALL"/>
+```
+
+**📌 Built-in Permission Functions:**
+
+✅ **checkPermissionStatus()** - Check current permission status:
+```javascript
+import { checkPermissionStatus } from 'omikit-plugin';
+
+const permissionStatus = await checkPermissionStatus();
+console.log(permissionStatus);
+// Output: { essentialGranted: [...], essentialMissing: [...], canMakeVoipCalls: true/false }
+```
+
+✅ **checkAndRequestPermissions()** - Request all necessary permissions:
+```javascript
+import { checkAndRequestPermissions } from 'omikit-plugin';
+
+const isVideo = true; // Set to true if video call permissions needed
+const permissionsGranted = await checkAndRequestPermissions(isVideo);
+if (permissionsGranted) {
+  console.log('All permissions granted!');
+}
+```
+
+✅ **requestPermissionsByCodes()** - Request specific permissions by error codes:
+```javascript
+import { requestPermissionsByCodes } from 'omikit-plugin';
+
+// Request specific permissions based on error codes from OmiSDK
+const codes = [450, 451, 452]; // Permission error codes
+const result = await requestPermissionsByCodes(codes);
+
+/* 
+Permission Code Mapping:
+- 450: RECORD_AUDIO permission (Android 14+)
+- 451: FOREGROUND_SERVICE permissions (Android 14+) 
+- 452: POST_NOTIFICATIONS permission (Android 13+)
+*/
+```
+
+**📌 System Alert Window Permission:**
+```javascript
+import { requestSystemAlertWindowPermission } from 'omikit-plugin';
+
+const canDrawOverlays = await requestSystemAlertWindowPermission();
+```
+
 - ✅ Set up <a href="https://rnfirebase.io/messaging/usage">Cloud Messaging</a> plugin:
 
 ```
@@ -695,6 +762,49 @@ if (result){
 }
 ```
 
+📌 **checkCredentials()** *(OmiSDK 2.3.67+)*
+
+✅ Description: Check credentials without maintaining connection. Useful for validating login information before actual registration.
+
+```javascript
+import { checkCredentials } from 'omikit-plugin';
+
+const loginInfo = {
+  userName: "your_username",
+  password: "your_password", 
+  realm: "your_realm",
+  fcmToken: "your_fcm_token",
+  projectId: "your_project_id"
+};
+
+const result = await checkCredentials(loginInfo);
+console.log(result); 
+// Output: { success: true/false, statusCode: number, message: string }
+```
+
+📌 **registerWithOptions()** *(OmiSDK 2.3.67+)*
+
+✅ Description: Register with full control over notification and auto-unregister behavior.
+
+```javascript
+import { registerWithOptions } from 'omikit-plugin';
+
+const loginInfo = {
+  userName: "your_username",
+  password: "your_password",
+  realm: "your_realm", 
+  isVideo: true,
+  fcmToken: "your_fcm_token",
+  projectId: "your_project_id",
+  showNotification: false,      // Control notification display
+  enableAutoUnregister: false   // Control auto-unregister behavior
+};
+
+const result = await registerWithOptions(loginInfo);
+console.log(result);
+// Output: { success: true/false, statusCode: number, message: string }
+```
+
 📌 **configPushNotification()**
 
 ✅ Description: Config push notification: func is used to configure the incoming call popup UI on Android and the representative name for iOS
@@ -1001,6 +1111,39 @@ const result = await startCallWithUuid({
     logout();
 ```
 
+📌 **hideSystemNotificationSafely()** *(OmiSDK 2.3.67+)*
+
+✅ Description: Safely hide system notification and unregister after a delay.
+
+```javascript
+import { hideSystemNotificationSafely } from 'omikit-plugin';
+
+const success = await hideSystemNotificationSafely();
+// Hides notification and unregisters after 2 seconds
+```
+
+📌 **hideSystemNotificationOnly()** *(OmiSDK 2.3.67+)*
+
+✅ Description: Hide system notification only, without unregistering.
+
+```javascript
+import { hideSystemNotificationOnly } from 'omikit-plugin';
+
+const success = await hideSystemNotificationOnly();
+// Keeps registration active but hides notification
+```
+
+📌 **hideSystemNotificationAndUnregister()** *(OmiSDK 2.3.67+)*
+
+✅ Description: Hide notification and unregister with custom reason.
+
+```javascript
+import { hideSystemNotificationAndUnregister } from 'omikit-plugin';
+
+const success = await hideSystemNotificationAndUnregister("User logout");
+// Hides notification and unregisters immediately with reason
+```
+
 📌 **systemAlertWindow()**
 
 ✅ Description: Check system alert window permission (only Android).
@@ -1285,6 +1428,40 @@ const onSwitchboardAnswer = (data: any) => {
 | `864`           | Temporary block on Mobifone direction, please try again |
 | `865`           | he advertising number is currently outside the permitted calling hours, please try again later |
 
+# 🔥 Android 15+ Compatibility Features
+
+## ✨ New in Version 3.3.5+
+
+### **Enhanced Permission Management**
+- **Full Android 15 (SDK 35+) Support**: Automatic handling of new foreground service permissions
+- **Smart Permission Requests**: Built-in functions to request specific permissions by error codes
+- **Comprehensive Status Checking**: Real-time permission status monitoring
+- **Version-Aware Logic**: Automatically handles Android version differences
+
+### **Advanced Registration Options** *(OmiSDK 2.3.67+)*
+- **Silent Registration**: Register without notifications or auto-unregister
+- **Credential Validation**: Check login credentials without connecting
+- **Custom Registration**: Full control over notification and unregister behavior
+- **Notification Management**: Fine-grained control over system notifications
+
+### **Error Code Mapping**
+Complete mapping of OmiSDK status codes to user-friendly error messages:
+- **450**: RECORD_AUDIO permission required for Android 14+
+- **451**: FOREGROUND_SERVICE permission required
+- **452**: POST_NOTIFICATIONS permission required for Android 13+
+- **500-600**: Service and network error handling
+- **Detailed Messages**: Customer-friendly error descriptions for easier integration
+
+### **Development Workflow**
+- **copy_dev.sh**: Efficient development workflow for testing native code changes
+- **Automatic Build Fixes**: Handles gradle namespace issues automatically
+- **Hot Reload**: Quick testing without npm publishing
+
+### **Breaking Changes**
+- **Android 15+ Support**: Requires additional permissions in AndroidManifest.xml
+- **New Architecture**: Still requires `newArchEnabled=false`
+- **Minimum SDK**: Android SDK 21+ recommended for full feature support
+
 # ⚠️ Issues
 
 

package/android/build.gradle

@@ -62,6 +62,7 @@ def getExtOrIntegerDefault(name) {
 }
 
 android {
+  namespace "com.omikitplugin"
   compileSdkVersion getExtOrIntegerDefault("compileSdkVersion")
 
   defaultConfig {
@@ -121,7 +122,7 @@ dependencies {
   implementation("androidx.work:work-runtime:2.8.1")
   implementation "androidx.security:security-crypto:1.1.0-alpha06"
   // api 'vn.vihat.omicall:omi-sdk:2.3.23'
-  api "io.omicrm.vihat:omi-sdk:2.3.87"
+  api "io.omicrm.vihat:omi-sdk:2.3.88"
 
   implementation "com.facebook.react:react-native:+" // From node_modules
   implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"