InfraredTorchControl 클래스

정의

네임스페이스:

Windows.Media.Devices

캡처 디바이스에서 적외선 토치 LED 설정을 제어하는 기능을 제공합니다.

public ref class InfraredTorchControl sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 524288)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class InfraredTorchControl final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 524288)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class InfraredTorchControl

Public NotInheritable Class InfraredTorchControl

상속

Object Platform::Object IInspectable InfraredTorchControl

특성

ContractVersionAttribute MarshalingBehaviorAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10, version 1903 (10.0.18362.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v8.0에서 도입되었습니다.)

예제

using Windows.Media.Capture;

MediaCapture mediaCapture = new MediaCapture();

public MainPage()
{
    this.InitializeComponent();
}

protected override async void OnNavigatedTo(NavigationEventArgs e)
{
    await mediaCapture.InitializeAsync();

    // Preview is Windows.UI.Xaml.Controls.CaptureElement defined in XAML file
    // and used to render camera preview
    Preview.Source = mediaCapture;
    await mediaCapture.StartPreviewAsync();

    if (!TryIncrementInfraredPower())
    {
        Debug.WriteLine("Failed to increment InfraredTorch power");
    }
}

private bool TryIncrementInfraredPower()
{
    bool incrementSucceeded = false;

    if (mediaCapture.VideoDeviceController.InfraredTorchControl.IsSupported)
    {
        Debug.WriteLine("IR torch supported");
        InfraredTorchControl infraredTorchControl = mediaCapture.VideoDeviceController.InfraredTorchControl;
        var maxPower = infraredTorchControl.MaxPower;
        var powerStep = infraredTorchControl.PowerStep;
        var oldPower = infraredTorchControl.Power;

        if (oldPower < maxPower)
        {
            infraredTorchControl.Power = oldPower + powerStep;
            incrementSucceeded = true;
        }
        else
        {
            Debug.WriteLine("InfraredTorch is already at max power");
        }
    }

    return incrementSucceeded;
}

설명

적외선TorchControl을 사용하면 앱이 적외선 LED의 전원과 동작을 제어할 수 있습니다.

디바이스가 이 컨트롤을 지원하는지 확인하려면 InfraredTorchControl.IsSupported를 확인하세요.

MediaCapture.VideoDeviceController를 통해 캡처 디바이스에 대한 InfraredTorchControl에 액세스할 수 있습니다.

속성

CurrentMode	적외선 LED의 현재 작동 모드를 가져옵니다.
IsSupported	캡처 디바이스가 InfraredTorchControl을 지원하는지 나타내는 값을 가져옵니다.
MaxPower	캡처 디바이스에서 지원하는 최대 적외선 LED 전원 값을 가져옵니다.
MinPower	캡처 디바이스에서 지원하는 최소 적외선 LED 전원 값을 가져옵니다.
Power	현재 적외선 LED 전원 값을 가져오거나 설정합니다.
PowerStep	지원되는 전원 단계 값을 가져옵니다.
SupportedModes	SupportedModes 속성은 적외선 LED가 지원하는 모드를 찾는 데 사용됩니다.

추가 정보

• VideoDeviceController