requestPermission

requestPermission(permission: string, desc?: string): Promise<number>;

• Promise<number>：用户授权结果，0 表示不允许，1 表示仅本次允许，2 表示始终允许，-1 表示用户直接关闭了申请弹框（未做选择，效果等同不允许，下次调用会重新弹框）

• 宿主可能会弹出授权对话框，供用户在“仅本次允许 / 始终允许 / 不允许”之间选择（默认选中“仅本次允许”）
• desc 只用于自定义“不允许”状态弹框中的说明文案，不会改变权限状态或用户可选择的授权选项。
• “仅本次允许”只在本次插件会话内有效，插件退出或关闭后会失效；只有“始终允许”会被持久化保存，重启插件后依然有效，详见插件权限

• 当 permission 不是非空字符串，或传入的 desc 不是字符串时，会抛出参数校验异常
• 当 permission 不在支持列表内时，会抛出异常（错误码 1502）
• 当插件未在 PluginConfig.json 的 uses-permissions 中声明该权限时，会抛出异常（错误码 1500）

​

示例

import { PluginManager } from 'sn-plugin-lib';

/**
 * 申请网络权限的示例。
 */
export async function exampleRequestPermission() {
  const permission = 'plugin.permission.INTERNET';
  const desc = '需要网络权限来同步插件数据。';
  const result = await PluginManager.requestPermission(permission, desc);
  return result;
}