Skip to content

AVCaptureDeviceInput ​

AVCaptureDeviceInput 表示把一个摄像头接进 AVCaptureSession 的输入。用一个 AVCaptureDevice 建出来,用会话的 addInput() 加进去之后,会话从这个摄像头取画面。

建它的那一刻要用到摄像头:还没问过用户时,系统在这一刻弹出授权的提示框;用户没有授权时建不出来。见 AVCaptureDevice。

它属于 @nacrejs/av-capture 这个包,安装见 AVCaptureSession。

继承关系:EventTarget → NSObject → AVCaptureInput → AVCaptureDeviceInput

构造函数 ​

AVCaptureDeviceInput()

把一个摄像头包成会话的输入。没有授权时抛 NSError。

实例属性 ​

还继承 NSObject 的属性。

属性说明
device 只读接的是哪个摄像头

实例方法 ​

没有自己的方法。

示例 ​

js
const session = new AVCaptureSession();
const camera = AVCaptureDevice.defaultDeviceWithMediaType('video');
if (camera !== null) {
  try {
    const input = new AVCaptureDeviceInput(camera);
    if (session.canAddInput(input)) session.addInput(input);
    console.log('接上了 ' + input.device.localizedName);
  } catch (err) {
    console.log('接不上摄像头:' + (err instanceof Error ? err.message : String(err)));
  }
}

效果

  • 用户已经同意时,控制台输出 接上了 Back Camera(iPhone 14 上的名字)。
  • 还没问过用户时,new AVCaptureDeviceInput(camera) 这一下弹出授权的提示框。
  • 用户拒绝过时,控制台输出 接不上摄像头: 和系统给的原因。

对应的 iOS API ​

ObjCJS
[AVCaptureDeviceInput deviceInputWithDevice:device error:&error],失败时返回 nilnew AVCaptureDeviceInput(device),失败时抛 NSError,domain 是空串、code 是 0,系统给的原因在 message 里
input.deviceinput.device

参见 ​