init

react/features/mobile/permissions/functions.ts

@@ -0,0 +1,29 @@
+import { Alert, Linking, NativeModules } from 'react-native';
+
+import Platform from '../../base/react/Platform.native';
+
+/**
+ * Opens the settings panel for the current platform.
+ *
+ * @private
+ * @returns {void}
+ */
+export function openSettings() {
+    switch (Platform.OS) {
+    case 'android':
+        NativeModules.AndroidSettings.open().catch(() => {
+            Alert.alert(
+                'Error opening settings',
+                'Please open settings and grant the required permissions',
+                [
+                    { text: 'OK' }
+                ]
+            );
+        });
+        break;
+
+    case 'ios':
+        Linking.openURL('app-settings:');
+        break;
+    }
+}

react/features/mobile/permissions/middleware.ts

@@ -0,0 +1,66 @@
+import { Alert } from 'react-native';
+
+import { isRoomValid } from '../../base/conference/functions';
+import i18next from '../../base/i18n/i18next';
+import MiddlewareRegistry from '../../base/redux/MiddlewareRegistry';
+import { TRACK_CREATE_ERROR } from '../../base/tracks/actionTypes';
+
+import { openSettings } from './functions';
+
+/**
+ * Middleware that captures track permission errors and alerts the user so they
+ * can enable the permission themselves.
+ *
+ * @param {Store} store - The redux store.
+ * @returns {Function}
+ */
+MiddlewareRegistry.register(store => next => action => {
+    const result = next(action);
+
+    switch (action.type) {
+    case TRACK_CREATE_ERROR:
+        // XXX We do not currently have user interface outside of a conference
+        // which the user may tap and cause a permission-related error. If we
+        // alert whenever we (intend to) ask for a permission, the scenario of
+        // entering the WelcomePage, being asked for the camera permission, me
+        // denying it, and being alerted that there is an error is overwhelming
+        // me.
+        if (action.permissionDenied
+                && isRoomValid(
+                        store.getState()['features/base/conference'].room)) {
+            _alertPermissionErrorWithSettings(action.trackType);
+        }
+        break;
+    }
+
+    return result;
+});
+
+/**
+ * Shows an alert panel which tells the user they have to manually grant some
+ * permissions by opening Settings. A button which opens Settings is provided.
+ *
+ * @param {string} trackType - Type of track that failed with a permission
+ * error.
+ * @private
+ * @returns {void}
+ */
+function _alertPermissionErrorWithSettings(trackType: string) {
+    /* eslint-disable indent */
+    const message = trackType === 'video'
+        ? i18next.t('dialog.permissionCameraRequiredError')
+        : i18next.t('dialog.permissionMicRequiredError');
+    /* eslint-ensable indent */
+
+    Alert.alert(
+        i18next.t('dialog.permissionErrorTitle'),
+        message,
+        [
+            { text: i18next.t('dialog.Cancel') },
+            {
+                onPress: openSettings,
+                text: i18next.t('settings.title')
+            }
+        ],
+        { cancelable: false });
+}