JavaScript的状态 调查又回来了

文档 插件 CLI

@电容器/相机

相机API提供了与相机合影或从相机中选择现有拍照的能力。

安装


              NPM
             
              安装
             @电容器/相机NPX帽
              同步

ios

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注意

PWA元素 相机插件需要工作。

例子


              进口
             
              {
             相机
              ,,,,
             摄影
              }
             
              
             
              '@电容器/相机'
              ;
             
              const
             
              拍照片
             
              =
             
              异步
             
              ((
              
             
              =>
             
              {
             
              const
             图片
              =
             
              等待
             相机
              
              getphoto
              ((
              {
             质量
              
             
              90
              ,,,,
             允许
              
             
              真的
              ,,,,
             结果类型
              
             摄影
              
             Uri
              }
              
              ;
             
              // image.webpath将包含一个可以设置为图像SRC的路径。
             
              //您可以使用image.path访问原始文件,可以是
             
              //传递到文件系统API以读取图像的原始数据,
             
              //如果需要(或通过resulttype:cameraresulttype.base64到GetPhoto)
             
              var
             ImageUrl
              =
             图片
              
             WebPath
              ;
             
              //现在可以将图像的SRC设置为
             Imagelement
              
             src
              =
             ImageUrl
              ;
             
              }
              ;

API

getphoto(…)


               getphoto
               ((
              选项
               
              ImageOptions
               
              
               =>
              
               承诺
               <
              照片
               >

提示用户从专辑中挑选照片,或用相机拍摄新照片。

参数 类型
选项 ImageOptions

返回: 承诺< 照片 >

自从: 1.0.0


皮卡(…)


               皮卡
               ((
              选项
               
              GalleryImageOptions
               
              
               =>
              
               承诺
               <
              画廊
               >

允许用户从照片库中选择多个图片。在iOS 13及以上,它只允许选择一张图片。

参数 类型
选项 GalleryImageOptions

返回: 承诺< 画廊 >

自从: 1.2.0


Checkpermissions()


               棋子仪
               ((
               
              
               =>
              
               承诺
               <
              参考
               >

检查摄像头和相册权限

返回: 承诺< 参考 >

自从: 1.0.0


请求Permissions(…)


               请求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

ImageOptions

支柱 类型 描述 默认 自从
质量 数字 从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

GalleryImageOptions

支柱 类型 描述 默认 自从
质量 数字 从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 []

类型别名

CamerapermessionState

参考州 |'有限的'

参考州

'提示'|``及时的理性''|“授予” |“拒绝”

camerapermessionType

'相机'|'相片'

枚举

摄影

成员 价值
Uri 'Uri'
基础64 'base64'
DataUrl 'dataUrl'

摄影师

成员 价值 描述
迅速的 '迅速的' 提示用户选择相册或拍照。
相机 '相机' 使用相机拍摄新照片。
相片 '相片' 选择画廊或相册的现有照片。

摄像头

成员 价值
后部 '后部'
正面 '正面'
以前的
< - 浏览器
下一个
剪贴板 - >
贡献 - >
Baidu