Xamarin.Essentials: 손전등Xamarin.Essentials: Flashlight

Flashlight 클래스에는 디바이스의 카메라 플래시를 켜거나 꺼서 손전등으로 전환하는 기능이 있습니다.The Flashlight class has the ability to turn on or off the device's camera flash to turn it into a flashlight.

시작Get started

이 API를 사용하기 전에 라이브러리가 제대로 설치되고 프로젝트에 설정되어 있는지 확인하기 위해 Xamarin.Essentials에 대한 시작 가이드를 읽어보세요.To start using this API, read the getting started guide for Xamarin.Essentials to ensure the library is properly installed and set up in your projects.

손전등 기능에 액세스하려면 다음 플랫폼 관련 설정이 필요합니다.To access the Flashlight functionality the following platform specific setup is required.

Flashlight 및 Camera 권한이 필요하며 Android 프로젝트에서 구성해야 합니다.The Flashlight and Camera permissions are required and must be configured in the Android project. 이 권한은 다음과 같은 방법으로 추가할 수 있습니다.This can be added in the following ways:

속성 폴더 아래의 AssemblyInfo.cs 파일을 열고 다음을 추가합니다.Open the AssemblyInfo.cs file under the Properties folder and add:

[assembly: UsesPermission(Android.Manifest.Permission.Flashlight)]
[assembly: UsesPermission(Android.Manifest.Permission.Camera)]

또는 Android 매니페스트를 업데이트합니다.OR Update Android Manifest:

속성 폴더 아래의 AndroidManifest.xml 파일을 열고 매니페스트 노드 내부에 다음을 추가합니다.Open the AndroidManifest.xml file under the Properties folder and add the following inside of the manifest node.

<uses-permission android:name="android.permission.FLASHLIGHT" />
<uses-permission android:name="android.permission.CAMERA" />

또는 Android 프로젝트를 마우스 오른쪽 단추로 클릭하고 프로젝트의 속성을 엽니다.Or right click on the Android project and open the project's properties. Android 매니페스트 아래에서 필요한 권한: 영역을 찾아 FLASHLIGHTCAMERA 권한을 확인합니다.Under Android Manifest find the Required permissions: area and check the FLASHLIGHT and CAMERA permissions. 그러면 AndroidManifest.xml 파일이 자동으로 업데이트됩니다.This will automatically update the AndroidManifest.xml file.

이러한 권한을 추가하면 특정 하드웨어 없이 Google Play에서 자동으로 디바이스를 필터링합니다.By adding these permissions Google Play will automatically filter out devices without specific hardware. Android 프로젝트에서 AssemblyInfo.cs 파일에 다음을 추가하여 이를 처리할 수 있습니다.You can get around this by adding the following to your AssemblyInfo.cs file in your Android project:

[assembly: UsesFeature("android.hardware.camera", Required = false)]
[assembly: UsesFeature("android.hardware.camera.autofocus", Required = false)]

손전등 사용Using Flashlight

클래스에서 Xamarin.Essentials에 대한 참조를 추가합니다.Add a reference to Xamarin.Essentials in your class:

using Xamarin.Essentials;

TurnOnAsyncTurnOffAsync 메서드를 통해 손전등을 켜고 끌 수 있습니다.The flashlight can be turned on and off through the TurnOnAsync and TurnOffAsync methods:

try
{
    // Turn On
    await Flashlight.TurnOnAsync();

    // Turn Off
    await Flashlight.TurnOffAsync();
}
catch (FeatureNotSupportedException fnsEx)
{
    // Handle not supported on device exception
}
catch (PermissionException pEx)
{
    // Handle permission exception
}
catch (Exception ex)
{
    // Unable to turn on/off flashlight
}

플랫폼 구현 관련 정보Platform Implementation Specifics

Flashlight 클래스는 디바이스의 운영 체제에 따라 최적화되었습니다.The Flashlight class has been optimized based on the device's operating system.

API 레벨 23 이상API Level 23 and Higher

최신 API 레벨에서 손전등 모드는 디바이스의 플래시 디바이스를 켜거나 끄는 데 사용됩니다.On newer API levels, Torch Mode will be used to turn on or off the flash unit of the device.

API 레벨 22 이하API Level 22 and Lower

카메라 표면 텍스처는 카메라 장치의 FlashMode을 켜거나 끄기 위해 만들어졌습니다.A camera surface texture is created to turn on or off the FlashMode of the camera unit.

APIAPI