相机API提供了与相机合影或从相机中选择现有拍照的能力。
NPM
安装
@电容器/相机NPX帽
同步
iOS需要在您的应用中添加以下用法说明并填写
info.plist
:
nscamerausateDescription
((
隐私 - 摄像机用法描述
)
nsphotolibraryAddusaDeDescription
((
隐私 - 图库添加使用说明
)
nsphotolibraryingescription
((
隐私 - 图库用法描述
)
阅读
配置
info.plist
在里面
iOS指南
有关在XCode中设置iOS权限的更多信息
此API需要将以下权限添加到您的
androidManifest.xml
:
<
用途
安卓:
姓名
=
“
android.permission.read__external_storage
“
/>
<
用途
安卓:
姓名
=
“
android.permission.write_external_storage
“
/>
存储权限用于读取/保存照片文件。
阅读 设置权限 在里面 Android指南 有关设置Android权限的更多信息。
此外,由于相机API启动了单独的活动来处理照片,因此您应该听
ApplestoredResult
在里面
应用程序
插件可以处理您的应用程序在活动运行时终止操作系统的任何相机数据。
该插件将使用以下项目变量(在您的应用程序的
变量
文件):
$ androidxexifinterfaceversion
:版本的
androidx.exifterface:exifinterface
(默认:
1.3.2
)
$ androidxmaterialversion
:版本的
com.google.android.material:材料
(默认:
1.3.0
)PWA元素 相机插件需要工作。
进口
{
相机
,,,,
摄影
}
从
'@电容器/相机'
;
const
拍照片
=
异步
((
)
=>
{
const
图片
=
等待
相机
。
getphoto
((
{
质量
:
90
,,,,
允许
:
真的
,,,,
结果类型
:
摄影
。
Uri
}
)
;
// image.webpath将包含一个可以设置为图像SRC的路径。
//您可以使用image.path访问原始文件,可以是
//传递到文件系统API以读取图像的原始数据,
//如果需要(或通过resulttype:cameraresulttype.base64到GetPhoto)
var
ImageUrl
=
图片
。
WebPath
;
//现在可以将图像的SRC设置为
Imagelement
。
src
=
ImageUrl
;
}
;
getphoto
((
选项
:
ImageOptions
)
=>
承诺
<
照片
>
提示用户从专辑中挑选照片,或用相机拍摄新照片。
参数 | 类型 |
---|---|
选项 |
ImageOptions |
返回:
承诺<
照片
>
自从: 1.0.0
皮卡
((
选项
:
GalleryImageOptions
)
=>
承诺
<
画廊
>
允许用户从照片库中选择多个图片。在iOS 13及以上,它只允许选择一张图片。
参数 | 类型 |
---|---|
选项 |
GalleryImageOptions |
返回:
承诺<
画廊
>
自从: 1.2.0
棋子仪
((
)
=>
承诺
<
参考
>
检查摄像头和相册权限
返回:
承诺<
参考
>
自从: 1.0.0
请求Permissions
((
权限
?
:
摄影剂
|
不明确的
)
=>
承诺
<
参考
>
请求摄像头和相册权限
参数 | 类型 |
---|---|
权限 |
摄影剂 |
返回:
承诺<
参考
>
自从: 1.0.0
支柱 | 类型 | 描述 | 自从 |
---|---|---|---|
base64String |
细绳 |
如果使用 cameraresulttype.base64 。 | 1.0.0 |
DataUrl |
细绳 |
URL以“数据:图像/jpeg; base64”开头,如果使用 CameraresultType.Dataurl 。 | 1.0.0 |
小路 |
细绳 |
如果使用 cameraresulttype.uri ,该路径将包含一个完整的,特定于平台的文件URL,可以在以后使用Filsystem API读取。 | 1.0.0 |
WebPath |
细绳 |
WebPath返回一条可用于设置图像的SRC属性以进行有效加载和渲染的路径。 | 1.0.0 |
exif |
任何 |
从图像中检索到Exif数据(如果有的话) | 1.0.0 |
格式 |
细绳 |
图像的格式,例如:jpeg,png,gif。iOS和Android仅支持JPEG。Web支持JPEG和PNG。仅当使用文件输入时,仅支持GIF。 | 1.0.0 |
保存 |
布尔 |
是否将图像保存到画廊中。在Android和iOS上,如果用户不授予所需的权限,则将保存到画廊的保存可能会失败。在网上没有画廊,所以总是返回错误。 | 1.1.0 |
支柱 | 类型 | 描述 | 默认 | 自从 |
---|---|---|---|---|
质量 |
数字 |
从0-100起,返回jpeg的图像质量 | 1.0.0 | |
允许 |
布尔 |
是允许用户裁剪还是进行小型编辑(特定于平台)。在iOS 14+上仅支持 Camerasource.Camera ,但不是为了 camerasource.photos 。 | 1.0.0 | |
结果类型 |
摄影 |
如何返回数据。目前,仅支持“ base64”,“ dataUrl”或“ uri” | 1.0.0 | |
Savetogallery |
布尔 |
是否将照片保存到画廊。如果照片是从画廊中挑选的,则只有编辑才能保存。 |
: 错误的 |
1.0.0 |
宽度 |
数字 |
保存图像的宽度 | 1.0.0 | |
高度 |
数字 |
保存图像的高度 | 1.0.0 | |
保存 |
布尔 |
此设置无效。图片调整始终保持纵横比。 | 1.0.0 | |
正确方向 |
布尔 |
是否要自动旋转图像“向上”以纠正肖像模式下的方向 |
: 真的 |
1.0.0 |
资源 |
摄影师 |
从中获取照片的来源。默认情况下,这会提示用户选择相册或拍照。 |
:camerasource.prompt |
1.0.0 |
方向 |
摄像头 |
仅iOS和网络:相机方向。 |
:cameradirection.Rear |
1.0.0 |
演示风格 |
'Fullscreen'|“弹出” |
仅iOS:相机的演示样式。 |
: '全屏' |
1.0.0 |
WebuseInput |
布尔 |
仅WEB:是使用PWA元素体验还是文件输入。默认值是使用PWA元素,如果已安装并倒退到文件输入。要始终使用文件输入,请将其设置为
真的
。了解有关PWA元素的更多信息:
https://capacitorjs.com/docs/pwa-elements |
1.0.0 | |
Pickerlabelheader |
细绳 |
显示提示时要使用的文本值。 |
: '照片' |
1.0.0 |
PickerlabelCancel |
细绳 |
显示提示时要使用的文本值。仅iOS:“取消”按钮的标签。 |
: '取消' |
1.0.0 |
Pickerlabelphoto |
细绳 |
显示提示时要使用的文本值。按钮的标签选择保存的图像。 |
:'来自照片' |
1.0.0 |
PickerlabelPicture |
细绳 |
显示提示时要使用的文本值。按钮打开相机的标签。 |
: '拍照片' |
1.0.0 |
支柱 | 类型 | 描述 | 自从 |
---|---|---|---|
相片 |
画廊[] |
所有采摘照片的阵列。 | 1.2.0 |
支柱 | 类型 | 描述 | 自从 |
---|---|---|---|
小路 |
细绳 |
完整的,特定于平台的文件URL,可以在以后使用Filsystem API读取。 | 1.2.0 |
WebPath |
细绳 |
WebPath返回一条可用于设置图像的SRC属性以进行有效加载和渲染的路径。 | 1.2.0 |
exif |
任何 |
从图像中检索到Exif数据(如果有的话) | 1.2.0 |
格式 |
细绳 |
图像的格式,例如:jpeg,png,gif。iOS和Android仅支持JPEG。Web支持JPEG,PNG和GIF。 | 1.2.0 |
支柱 | 类型 | 描述 | 默认 | 自从 |
---|---|---|---|---|
质量 |
数字 |
从0-100起,返回jpeg的图像质量 | 1.2.0 | |
宽度 |
数字 |
保存图像的宽度 | 1.2.0 | |
高度 |
数字 |
保存图像的高度 | 1.2.0 | |
正确方向 |
布尔 |
是否要自动旋转图像“向上”以纠正肖像模式下的方向 |
: 真的 |
1.2.0 |
演示风格 |
'Fullscreen'|“弹出” |
仅iOS:相机的演示样式。 |
: '全屏' |
1.2.0 |
限制 |
数字 |
仅iOS:用户可以选择的最大图片数。 |
0(无限) |
1.2.0 |
支柱 | 类型 |
---|---|
相机 |
CamerapermessionState |
相片 |
CamerapermessionState |
支柱 | 类型 |
---|---|
权限 |
camerapermessionType [] |
参考州
|'有限的'
'提示'|``及时的理性''|“授予” |“拒绝”
'相机'|'相片'
成员 | 价值 |
---|---|
Uri |
'Uri' |
基础64 |
'base64' |
DataUrl |
'dataUrl' |
成员 | 价值 | 描述 |
---|---|---|
迅速的 |
'迅速的' |
提示用户选择相册或拍照。 |
相机 |
'相机' |
使用相机拍摄新照片。 |
相片 |
'相片' |
选择画廊或相册的现有照片。 |
成员 | 价值 |
---|---|
后部 |
'后部' |
正面 |
'正面' |