تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 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 }"]]