On this page
BackgroundRecommended Solution1. Intercom Feature2. Recording & Screenshot Feature

Intercom & Recording Permissions

During IPC panel development, features like intercom, recording, and screenshot require explicit user permissions:

  • Intercom: Microphone permission (scope.record)
  • Recording/Screenshot: Storage/Photos permission (scope.writePhotosAlbum)

Background

  • When invoking permission-required features for the first time on iOS or Android, the system will show a permission popup where users can allow or deny access.
  • ⚠️ If the user denies permission, the system will not show the popup again automatically, and existing APIs cannot trigger it. Calling permission-related APIs will fail, so developers must guide users to manually enable permissions in system settings.

1. Intercom Feature

Enable Intercom

  1. Check the microphone permission status (ty.authorizeStatus)
  2. If it returns fail → permission has never been requested → call ty.authorize to request permission
  3. If ty.authorize also returns fail → user previously denied → show a custom modal guiding the user to system settings
  4. If success → permission granted → call intercom directly

Example Code

import { showModal, openAppSystemSettingPage } from '@ray-js/ray';

// Custom modal to guide users to system settings
const showCustomDialog = () => {
  showModal({
    title: '',
    content: 'You currently do not have access to the microphone. Please enable it in Settings.',
    cancelText: 'Cancel',
    confirmText: 'Go to Settings',
    isShowGlobal: true,
    success: res => {
      if (res.confirm) {
        openAppSystemSettingPage({
          scope: 'App-Settings',
          success: () => {
            console.log('Navigation successful');
          },
        });
      }
    },
  });
};

const startTalkTest = () => {
  // 1. Check microphone permission
  ty.authorizeStatus({
    scope: 'scope.record',
    success: () => {
      // Permission granted, call intercom directly
    },
    fail: () => {
      // 2. Request microphone permission
      ty.authorize({
        scope: 'scope.record',
        success: () => {
          // Permission granted, call intercom directly
        },
        fail: () => {
          // 3. User previously denied, show custom modal
          showCustomDialog();
        },
      });
    },
  });
};

2. Recording & Screenshot Feature

Enable Recording or Screenshot

  1. Check storage/photos permission status (ty.authorizeStatus)
  2. If it returns (fail) → permission has never been requested → call (ty.authorize)
  3. If (ty.authorize) returns (fail) → user previously denied → guide the user to manually enable it in system settings
  4. If it returns (success) → permission granted → recording or screenshot can be used directly

💡 Note: After starting recording, wait at least 3 seconds before stopping; otherwise, errors may likely occur

Example Code

import { showModal, openAppSystemSettingPage } from '@ray-js/ray';

// Custom modal to guide users to system settings
const showCustomDialog = () => {
  showModal({
    title: '',
    content: 'You currently do not have access to storage/photos. Please enable it in Settings.',
    cancelText: 'Cancel',
    confirmText: 'Go to Settings',
    isShowGlobal: true,
    success: res => {
      if (res.confirm) {
        openAppSystemSettingPage({
          scope: 'App-Settings',
          success: () => {
            console.log('Navigation successful');
          },
        });
      }
    },
  });
};

const startRecordTest = () => {
  // 1. Check storage/photos permission
  ty.authorizeStatus({
    scope: 'scope.writePhotosAlbum',
    success: () => {
      // Permission granted, use recording or screenshot features
      console.log('Permission granted');
    },
    fail: () => {
      // 2. Request storage/photos permission
      ty.authorize({
        scope: 'scope.writePhotosAlbum',
        success: () => {
          // Permission granted, use recording or screenshot features
          console.log('Permission granted');
        },
        fail: () => {
          // 3. User previously denied, show custom modal
          showCustomDialog();
        },
      });
    },
  });
};