
小程序原生能力调用报错:api scope is not declared
小程序开发过程中,调用原生API(例如chooseAvatar选择头像)时,可能会遇到“api scope is not declared in the privacy agreement”的错误提示。 这是因为小程序缺少必要的权限声明。
解决方案:在隐私协议中声明权限
解决方法是将所需API的权限声明添加到小程序的app.json文件中的privacy字段。
-
确认
app.json文件存在: 确保你的小程序根目录下存在app.json文件。如果没有,请创建该文件。 -
在
app.json中添加权限声明: 在app.json文件中添加或修改privacy字段,声明所需权限。 例如,chooseAvatarAPI需要camera权限:
{
"privacy": {
"scopes": ["camera"]
}
}
如果需要多个权限,可以在scopes数组中添加多个权限,例如:
{
"privacy": {
"scopes": ["camera", "location"]
}
}
- 重新编译小程序: 完成以上步骤后,重新编译并运行小程序。
代码示例 (完整示例)
以下是一个包含chooseAvatar API调用的完整代码示例,以及正确的app.json配置:
app.json:
{
"privacy": {
"scopes": ["camera"]
}
}
页面代码 (例如:index.js):
Page({
onChooseAvatarTap: function() {
wx.chooseAvatar({
count: 1,
success: (res) => {
console.log(res.avatarUrl); // 获取选择的头像URL
},
fail: (err) => {
console.error("选择头像失败:", err);
}
});
}
});
记住,你需要根据你调用的具体API,添加相应的权限。 完整的权限列表请参考小程序官方文档。 在添加权限后,务必重新编译你的小程序。










