在 iOS 设备上使用设备的闪光灯
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
在 AR 会话期间启用设备的闪光单元有助于提高可见度。
检查当前摄像头配置是否支持闪光灯
并非所有相机配置都支持启用闪光灯。在启用闪光灯或向用户提供启用闪光灯的选项之前,请确保闪光灯单元适用于当前的相机配置:
AVCaptureDevice *device = [AVCaptureDevice defaultDeviceWithMediaType:AVMediaTypeVideo];
if (device) {
return device.hasTorch;
}
return false;
启用闪光灯
使用 AVCaptureTorchModeOn
配置 AR 会话,以启用闪光灯单元:
AVCaptureDevice *device = [AVCaptureDevice defaultDeviceWithMediaType:AVMediaTypeVideo];
if (device) {
if (device.hasTorch) {
NSError *error = nil;
if ([device lockForConfiguration:&error]) {
device.torchMode = AVCaptureTorchModeOn;
[device unlockForConfiguration];
} else {
return;
}
}
}
停用闪光灯
使用 AVCaptureTorchModeOff
配置 AR 会话,以停用闪光灯单元:
AVCaptureDevice *device = [AVCaptureDevice defaultDeviceWithMediaType:AVMediaTypeVideo];
if (device) {
if (device.hasTorch) {
NSError *error = nil;
if ([device lockForConfiguration:&error]) {
device.torchMode = AVCaptureTorchModeOff;
[device unlockForConfiguration];
} else {
return;
}
}
}
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-26。
[null,null,["最后更新时间 (UTC):2025-07-26。"],[[["\u003cp\u003eUsing the device's flash during an AR session can enhance visibility in low-light conditions.\u003c/p\u003e\n"],["\u003cp\u003eBefore enabling the flash, verify if the active camera configuration supports it by checking the \u003ccode\u003ehasTorch\u003c/code\u003e property of the \u003ccode\u003eAVCaptureDevice\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eEnable the flash by setting the \u003ccode\u003etorchMode\u003c/code\u003e property of the \u003ccode\u003eAVCaptureDevice\u003c/code\u003e to \u003ccode\u003eAVCaptureTorchModeOn\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eDisable the flash by setting the \u003ccode\u003etorchMode\u003c/code\u003e property of the \u003ccode\u003eAVCaptureDevice\u003c/code\u003e to \u003ccode\u003eAVCaptureTorchModeOff\u003c/code\u003e.\u003c/p\u003e\n"]]],["To utilize the device's flash in an AR session, first verify if the active camera configuration supports it using `device.hasTorch`. If supported, enable the flash by setting `device.torchMode` to `AVCaptureTorchModeOn` after locking the device for configuration. If the camera doesn't support flash, setting `AVCaptureTorchModeOn` will have no effect. To disable it set the `device.torchMode` to `AVCaptureTorchModeOff` and unlock the configuration.\n"],null,["# Use the device's flash unit on iOS\n\n\u003cbr /\u003e\n\nEnabling the device's flash unit during an AR session can help improve\nvisibility.\n\nCheck that the current camera configuration supports flash\n----------------------------------------------------------\n\nNot all camera configurations support enabling a flash unit.\nBefore enabling the flash or offering users the option to enable the flash,\nensure that the flash unit is available for the active camera\nconfiguration: \n\n AVCaptureDevice *device = [AVCaptureDevice defaultDeviceWithMediaType:AVMediaTypeVideo];\n if (device) {\n return device.hasTorch;\n }\n return false;\n\nEnable the flash unit\n---------------------\n\nEnable the flash unit by configuring the AR session with\n[`AVCaptureTorchModeOn`](https://developer.apple.com/documentation/avfoundation/avcapturetorchmode/avcapturetorchmodeon): \n\n AVCaptureDevice *device = [AVCaptureDevice defaultDeviceWithMediaType:AVMediaTypeVideo];\n if (device) {\n if (device.hasTorch) {\n NSError *error = nil;\n if ([device lockForConfiguration:&error]) {\n device.torchMode = AVCaptureTorchModeOn;\n [device unlockForConfiguration];\n } else {\n return;\n }\n }\n }\n\n| **Note:** Configuring [`AVCaptureTorchModeOn`](https://developer.apple.com/documentation/avfoundation/avcapturetorchmode/avcapturetorchmodeon) with a camera configuration that does not support a flash unit will have no effect.\n\nDisable the flash unit\n----------------------\n\nDisable the flash unit by configuring the AR session with\n[`AVCaptureTorchModeOff`](https://developer.apple.com/documentation/avfoundation/avcapturetorchmode/avcapturetorchmodeoff): \n\n AVCaptureDevice *device = [AVCaptureDevice defaultDeviceWithMediaType:AVMediaTypeVideo];\n if (device) {\n if (device.hasTorch) {\n NSError *error = nil;\n if ([device lockForConfiguration:&error]) {\n device.torchMode = AVCaptureTorchModeOff;\n [device unlockForConfiguration];\n } else {\n return;\n }\n }\n }"]]