LightSensor 類別

定義

命名空間:

Windows.Devices.Sensors

表示環境光線感應器，提供環境光線讀數做為 LUX 值。

public ref class LightSensor sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class LightSensor final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class LightSensor

Public NotInheritable Class LightSensor

繼承

Object Platform::Object IInspectable LightSensor

屬性

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 需求

裝置系列	Windows 10 (已於 10.0.10240.0 引進)
API contract	Windows.Foundation.UniversalApiContract (已於 v1.0 引進)

範例

如需範例實作，請參閱光感應器範例。

備註

下列範例示範使用 XAML 和 C# 建置的 UWP 應用程式如何使用 GetDefault 方法來建立光線感應器的連線。 如果找不到整合式光線感應器，此方法會傳回 Null 值。

_sensor = LightSensor.GetDefault();

下列範例示範如何使用 XAML 建置的 UWP 應用程式註冊 ReadingChanged 事件處理常式。

private void ScenarioEnable(object sender, RoutedEventArgs e)
{
    if (_sensor != null)
    {
        // Establish the report interval
        _sensor.ReportInterval = _desiredReportInterval;

        Window.Current.VisibilityChanged += new WindowVisibilityChangedEventHandler(VisibilityChanged);
        _sensor.ReadingChanged += new TypedEventHandler<LightSensor, LightSensorReadingChangedEventArgs>(ReadingChanged);

        ScenarioEnableButton.IsEnabled = false;
        ScenarioDisableButton.IsEnabled = true;
    }
    else
    {
        rootPage.NotifyUser("No light sensor found", NotifyType.StatusMessage);
    }
}

下列範例顯示 ReadingChanged 事件處理常式。

async private void ReadingChanged(object sender, LightSensorReadingChangedEventArgs e)
{
    await Dispatcher.RunAsync(CoreDispatcherPriority.Normal, () =>
    {
        LightSensorReading reading = e.Reading;
        ScenarioOutput_LUX.Text = String.Format("{0,5:0.00}", reading.IlluminanceInLux);
    });
}

版本歷程記錄

Windows 版本	SDK 版本	已新增值
1709	16299	FromIdAsync
1709	16299	GetDeviceSelector
1709	16299	MaxBatchSize
1709	16299	ReportLatency
2004	19041	ReportThreshold

屬性

DeviceId	取得裝置識別碼。
MaxBatchSize	取得感應器可批次處理的事件數目上限。
MinimumReportInterval	取得感應器支援的最小報告間隔。
ReportInterval	取得或設定環境光線感應器的目前報表間隔。
ReportLatency	取得或設定感應器資訊批次之間的延遲。
ReportThreshold	取得光線感應器的 LightSensorDataThreshold 。

方法

FromIdAsync(String)	以非同步方式從其識別碼取得感應器。
GetCurrentReading()	取得目前的環境光線感應器讀數。
GetDefault()	傳回預設的環境光線感應器。
GetDeviceSelector()	取得裝置選取器。

事件

ReadingChanged

每次環境光線感應器報告新的感應器讀數時發生。

另請參閱

• LightSensor 範例
• 光線感應器範例 (Windows 10)