> For the complete documentation index, see [llms.txt](https://developers-apps-in-toss.toss.im/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers-apps-in-toss.toss.im/documentation/api-and-sdk-zh/common/permission.md).

# 权限

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

{% hint style="info" %}
**WebView 环境 Web API**

在 WebView 环境中，不会限制普通 Web API 的使用。\
因此，浏览器中可用的大多数标准 Web API 都可以同样使用。
{% endhint %}

## 权限列表

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

### 摄像头

* 权限名称: [`camera`](/documentation/api-and-sdk-zh/common/permission/camera.md)
* 访问(`access`): openCamera

### 相册

* 权限名称: [`photos`](/documentation/api-and-sdk-zh/common/permission/album.md)
* 读取(`read`): fetchAlbumPhotos

### 剪贴板

* 权限名称: [`clipboard`](/documentation/api-and-sdk-zh/common/permission/clipboard.md)
* 读取(`read`): getClipboardText
* 写入(`write`): setClipboardText

### 联系人

* 权限名称: [`contacts`](/documentation/api-and-sdk-zh/common/permission/contact.md)
* 读取(`read`): fetchContacts

### 位置

* 权限名称: [`geolocation`](/documentation/api-and-sdk-zh/common/permission/location.md)
* 访问(`access`): startUpdateLocation, getCurrentLocation, useGeolocation

### 麦克风

* 权限名称: `microphone`
* 访问(`access`): 之后将支持。如果是 WebView，请使用 Web API 直接实现。

## 设置权限

应用中要使用的权限 `granite.config.ts`可定义在其中。这会在审核应用时使用。 [权限列表](#권한-목록)请参考并设置。

下面是设置为使用剪贴板、摄像头和相册的示例。

{% tabs %}
{% tab title="React Native" %}

```tsx
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',
        },
      ],
    }),
  ],
});
```

{% endtab %}

{% tab title="WebView" %}

```tsx
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',
    },
  ],
});
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developers-apps-in-toss.toss.im/documentation/api-and-sdk-zh/common/permission.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.