权限

如果要在应用中使用剪贴板、位置信息、相册、联系人等功能，需要设置权限。 我们将介绍如何设置权限，以便这些功能能在 Toss 应用中使用。

WebView 环境中的 Web API

在 WebView 环境中不会限制一般 Web API 的使用。 因此，可以与浏览器中可用的大多数标准 Web API 同样使用。

权限列表

下面是权限名称和允许的操作列表。也请确认每个权限对应的访问值。

相机

• 权限名称： camera
• 访问(access): openCamera

相册

• 权限名称： photos
• 读取(read): fetchAlbumPhotos

剪贴板

• 权限名称： clipboard
• 读取(read): getClipboardText
• 写入(write): setClipboardText

联系人

• 权限名称： contacts
• 读取(read): fetchContacts

位置

• 权限名称： geolocation
• 访问(access): startUpdateLocation, getCurrentLocation, useGeolocation

麦克风

• 权限名称： microphone
• 访问(access): 预计后续将支持。如果是 WebView，请使用 Web API 直接实现。

设置权限

应用中使用的权限 granite.config.ts可定义在……中。这在审核应用时会用到。 权限列表请参考……进行设置。

下面是设置为可使用剪贴板、相机和相册的示例。

React Native

import { appsInToss } from '@apps-in-toss/framework/plugins';
import { defineConfig } from '@granite-js/react-native/config';

export default defineConfig({
  appName: '<my-service-name>',
  plugins: [
    appsInToss({
      permissions: [
        {
          name: 'clipboard',
          access: 'read',
        },
        {
          name: 'clipboard',
          access: 'write',
        },
        {
          name: 'camera',
          access: 'access',
        },
        {
          name: 'photos',
          access: 'read',
        },
      ],
    }),
  ],
});

WebView

import { defineConfig } from '@apps-in-toss/web-framework/config';

export default defineConfig({
  appName: '<my-service-name>', // 在 Apps in Toss 控制台中设置的应用名称
  web: {
    /* 现有设置 */
  },
  permissions: [
    {
      name: 'clipboard',
      access: 'read',
    },
    {
      name: 'clipboard',
      access: 'write',
    },
    {
      name: 'camera',
      access: 'access',
    },
    {
      name: 'photos',
      access: 'read',
    },
  ],
});