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;
}

備註

InfraredTorchControl 可讓應用程式控制基礎結構 LED 的電源和行為。

您可以查看 InfraredTorchControl.IsSupported，以瞭解裝置是否支援此控制項。

您可以透過 MediaCapture.VideoDeviceController存取擷取裝置的 InfraredTorchControl。

屬性

CurrentMode	取得基礎結構 LED 的目前作業模式。
IsSupported	取得值，指出擷取裝置是否支援 InfraredTorchControl。
MaxPower	取得擷取裝置所支援的最大基礎結構 LED 電源值。
MinPower	取得擷取裝置支援的最小基礎結構 LED 電源值。
Power	取得或設定目前的基礎結構 LED 電源值。
PowerStep	取得支援的電源步驟值。
SupportedModes	SupportedModes 屬性可用來找出基礎結構 LED 支援的模式。

另請參閱

• VideoDeviceController