環境光センサー — Ambient Light Sensor

【この訳に特有な表記規約】

1. 序論

`~ambient光~sensor^cite（ `Ambient Light Sensor^en ）は、 `汎用~sensor~API^cite（ `Generic Sensor API^en ） `GENERIC-SENSOR$r を拡張して，［ ~deviceの~main光~検出器により検出された~ambient光~level ］についての情報を~lux単位で供する。 ◎ The Ambient Light Sensor extends the Generic Sensor API [GENERIC-SENSOR] to provide information about ambient light levels, as detected by the device’s main light detector, in terms of lux units.

2. 例

const %sensor = new AmbientLightSensor();
%sensor.onreading = () => console.log(%sensor.illuminance);
%sensor.onerror = %event => console.log(%event.error.name, %event.error.message);
%sensor.start();

navigator.permissions.query({ name: 'ambient-light-sensor' }).then(%result => {
    if (%result.state === 'denied') {
        console.log('~ambient光~sensorを利用する許可は否認されました。');
        return;
    }

    const %als = new AmbientLightSensor({frequency: 20});
    %als.addEventListener('activate', () => console.log('EV は今から測定できます。'));
    %als.addEventListener('error', %event => console.log(``^~error: ${%event.error.name}``^));
    %als.addEventListener('reading', () => {
        // 既定の~ISOspeed値
        const %ISO = 100;
        // 入射光較正定数
        const %C = 250;

        let %EV = Math.round(Math.log2((%als.illuminance * %ISO) / %C));
        console.log(``^~露光~値 (EV) : ${%EV}``^);
    });

    %als.start();
});

const %als = new AmbientLightSensor();

%als.onreading = () => {
    let %str = luxToWorkplaceLevel(%als.illuminance);
    if (%str) {
        console.log(``^${%str}用に相応しい光~levelです：``^);
    }
};

%als.start();

function luxToWorkplaceLevel(%lux) {
    if (20 <= %lux  && %lux < 100) {
        return '公共区域, 短い訪問';
    } else if (100 <= %lux && %lux < 150) {
        return 'たまに遂行される視覚的な~task';
    } else if (150 <= %lux && %lux < 250) {
        return '簡単な事務作業, 授業, 居宅, 劇場';
    } else if (250 <= %lux && %lux < 500) {
        return '通常の事務作業, 日用品店, 実験室';
    } else if (500 <= %lux && %lux < 1000) {
        return '製作所, 絵描き, 食料品店';
    } else if (1000 <= %lux && %lux < 5000) {
        return '製図作業, 低~contrastな視覚的な~task';
    }

    return;
}

3. ~security／~privacyの考慮点

◎追跡路 ~ambient光~sensorは、 ~device環境~近くの照明~条件について情報を供する。 これは、 次に挙げる~privacy~riskを含み得る： ◎ Ambient Light Sensor provides information about lighting conditions near the device environment. Potential privacy risks include:

• ~profile法 ⇒ ~ambient光~sensorは、 利用者の利用~patternや周囲について情報を漏洩し得る。 この情報は、 利用者を~profileしたり挙動上の分析を増補するために利用され得る。 ◎ Profiling. Ambient Light Sensor can leak information about user’s use patterns and surrounding. This information can be used to enhance user profiling and behavioral analysis.
• ~device間にまたがる~link法 ⇒ 2 つの~deviceは、 同じ第三者-主体に属する~scriptを含む~web~siteに~accessし得る — ~scriptは，時間~越しに照明~levelを相関する。 ◎ Cross-device linking. Two devices can access web sites that include the same third-party script that correlates lighting levels over time.
• ~device間をまたがる通信 ⇒ 近くにある~deviceにおける~ambient光~sensorで［ ~device~screenや~camera~LED~flashから読出された~message ］を，単純な~broadcast通信~手法を利用して~broadcastし得る。 ◎ Cross-device communication. A simple broadcast communication method can use device screen or camera LED flashes to broadcast messages read out with an Ambient Light Sensor in a close by device.
• 非同一-生成元への漏洩 ⇒ ~screenから発された光は、 近くの反射面から，~sensorへ戻るように反映され得る。 悪意的な~siteは、 異なる生成元からの資源を埋込んで， 内容を画素ごとに判別できるよう内容を拡大して特定0の画素を表示し得る。 ◎ Cross-origin leaks. Light emitted from the screen can be reflected back to the sensor from nearby reflective surfaces. Malicious sites can embed resources from different origins and scale the content to display particular pixels to allow distinguishing the contents, pixel by pixel.
• 閲覧~履歴の強奪 ⇒ ［ 訪問-済み／未訪問 ］な~linkに異なる光~levelを結付ける — すなわち、 ~screen内で［ 黒い／白い ］塊になるよう~styleする — ことにより，それらが判別できるようになる。 ◎ Hijacking browsing history. Styling visited links to allow distinguishing the light levels associated with visited and unvisited links i.e. visited links styled as a block of black screen; white for unvisited.

これらの課題を さらに掘下げる作業は、 次に挙げるものなどにある ⇒＃ `ALSPRIVACYANALYSIS$r, `PINSKIMMINGVIASENSOR$r, `STEALINGSENSITIVEDATA$r, `VIDEORECOGNITIONAMBIENTLIGHT$r, `IMAGINGPRIVACY$r ◎ Works such as [ALSPRIVACYANALYSIS], [PINSKIMMINGVIASENSOR], [STEALINGSENSITIVEDATA], [VIDEORECOGNITIONAMBIENTLIGHT], and [IMAGINGPRIVACY] delve further into these issues.

これらの，~ambient光~sensorに特有な脅威を軽減するため、 ~UAは ⇒＃ ~sensor読取りの`正確度を抑制する$モノトスル。 `最大~標本化~frequencyを制限しても＠~SENSORS#limit-max-frequency$ヨイ。 ◎ To mitigate these threats specific to Ambient Light Sensor, user agents must reduce accuracy of sensor readings. User agents may also limit maximum sampling frequency.

これらの軽減~策は、 `汎用~sensor~API^cite `GENERIC-SENSOR$r に定義される`汎用な軽減~策＠~SENSORS#mitigation-strategies$を補う。 ◎ These mitigation strategies complement the generic mitigations defined in the Generic Sensor API [GENERIC-SENSOR].

4. ~model

`~sensor型$ `~ambient光~sensor@i （ `Ambient Light Sensor^en ）は： ◎ ↓

• `Sensor$I 下位class【`拡張~sensor~interface$】として、 `AmbientLightSensor$I が結付けられる。 ◎ The Ambient Light Sensor sensor type’s associated Sensor subclass is the AmbientLightSensor class.
• その`既定の~sensor$は、 ~deviceの~main光~検出器である。 ◎ The Ambient Light Sensor has a default sensor, which is the device’s main light detector.
• `名前$ `ambient-light-sensor@l により識別される`強力な特能$である。 ◎ The Ambient Light Sensor is a powerful feature that is identified by the name "ambient-light-sensor",＼
• その`~sensor許可~名~群$は、 `ambient-light-sensor^l のみからなる。 ◎ which is also its associated sensor permission name.＼
• その`許可~revocation~algo$は、 次の結果を返す ⇒ `~sensor許可~revocation~algo$( `ambient-light-sensor^l ) ◎ Its permission revocation algorithm is the result of calling the generic sensor permission revocation algorithm with "ambient-light-sensor".
• `施策により制御される特能$であり、 文字列 `ambient-light-sensor^l により識別される。 その`既定の許容list$は `'self'^l とする。 ◎ The Ambient Light Sensor is a policy-controlled feature identified by the string "ambient-light-sensor". Its default allowlist is 'self'.
• それが`属する~virtual~sensor型$は、 `ambient-light@vsT とする。 ◎ The Ambient Light Sensor has a virtual sensor type, which is "ambient-light".

`現在の光~level@ （ `current light level^en ） — `現在の照度@ （ `current illuminance^en ）とも称される — は、 ~hostしている~device周りの~ambient光~levelを表現する値であり， その単位は~lux（ `lux^en ）（ lx ） `SI$r とする。 ◎ The current light level or illuminance is a value that represents the ambient light level around the hosting device. Its unit is the lux (lx) [SI].

注記： 報告される精確な~lux値は、 同じ光の下でも，~deviceごとに異なり得る — 検出~手法における相違点, ~sensorの構成, 等々に因り。 ◎ Note: The precise lux value reported by different devices in the same light can be different, due to differences in detection method, sensor construction, etc.

`~sensor型$ `~ambient光~sensor$i には： ◎ ↓

• ~luxで測定される `照度~読取り量子@ （ `illuminance rounding multiple^en †）がある — 各~照度~読取りは、 この~~量の整数倍に丸められることになる。

  【† この `multiple^en は， “倍数（~~整数倍）” を意味するが、 そのように対訳すると意味が通らなくなるので， “量子化” に対応する対訳に改めている。 】

  ◎ The Ambient Light Sensor has an illuminance rounding multiple, measured in lux, which represents a number whose multiples the illuminance readings will be rounded up to.
• ~luxで測定される `照度~threshold値@ （ `illuminance threshold value^en ）がある — それは、 `~ambient光の~threshold検査~algo$内で利用される。 ◎ The Ambient Light Sensor has an illuminance threshold value, measured in lux, which is used in the ambient light threshold check algorithm.

注記： これらに課される最小な要件は、 `§ ~sensor読取りの正確度の抑制-法＠#reduce-sensor-accuracy$を見よ。 ◎ Note: see § 3.1 Reducing sensor readings accuracy for minimum requirements for the values described above.

5. ~API

[`SecureContext$, `Exposed$=Window]
interface `AmbientLightSensor@I : `Sensor$I {
  `AmbientLightSensor$mc(optional `SensorOptions$I %sensorOptions = {});
  readonly attribute `double$? `illuminance$m;
};

6. 抽象-演算

7. 自動化

この節では、 `GENERIC-SENSOR$r に定義される`自動化＠~SENSORS#automation$を拡張する — `~ambient光~sensor$i に特有な`~virtual~sensor~metadata$を供することにより。 ◎ This section extends Generic Sensor API § 9 Automation by providing Ambient Light Sensor-specific virtual sensor metadata.

`型ごとの~virtual~sensor~metadata$を与える`~map$は、 次に挙げる`~entry$mapを伴うモノトスル： ◎ The per-type virtual sensor metadata map must have the following entry:

• `~key$map `ambient-light^l ⇒ 対応する`値$mapを与える`~virtual~sensor~metadata$の ⇒＃ `~virtual~sensor型$vsMは `~ambient光~sensor$i ／ `読取り構文解析~algo$vsMは `照度の読取りを構文解析する$ ◎ key • "ambient-light" ◎ value • A virtual sensor metadata whose virtual sensor type is Ambient Light Sensor and reading parsing algorithm is illuminance reading parsing algorithm.

8. 利用事例と要件

次に挙げるものを行う~Web~app： ◎ ↓

• ~smart居宅~system用に照明を制御する入力を供する。 ◎ A Web application provides input for a smart home system to control lighting.
• 作業~空間において光~levelは足るかどうか検査する。 ◎ A Web application checks whether light level at work space is sufficient.
• 手動で制御する~camera用の設定群（~aperture-shutter-speed-ISO）を計算する。 ◎ A Web application calculates settings for a camera with manual controls (aperture, shutter speed, ISO).
• 現在の光~levelを検査して，~camera~streamが［ 目的（例：ヒトが居るかどうか検証yする）に十分に正確aな~data ］を包含するかどうか決定する。 ◎ A Web application checks the current light level to determine whether a camera stream will contain data that is accurate enough for its purposes (e.g. human presence verification).

一部の利用事例では、 精確な~ambient光の測定を得することから便益が得られよう。 一方で，~ambient光~levelの変動を利用者~入力~eventへ変換する利用事例では、 より高い`標本化~frequency$から便益が得られよう。 ◎ While some of the use cases may benefit from obtaining precise ambient light measurements, the use cases that convert ambient light level fluctuations to user input events would benefit from higher sampling frequencies.

9. 謝辞

`Doug Turner^en 氏は、 初期の原型を寄せられた。 `Marcos Caceres^en 氏は~test一式を寄せられた。 ◎ Doug Turner for the initial prototype and Marcos Caceres for the test suite.

`Paul Bakaus^en 氏は、 `LightLevelSensor^i 案を寄せられた。 ◎ Paul Bakaus for the LightLevelSensor idea.

`Mikhail Pozdnyakov^en, `Alexander Shalamov^en 両氏は、 利用事例と要件を寄せられた。 ◎ Mikhail Pozdnyakov and Alexander Shalamov for the use cases and requirements.

`Lukasz Olejnik^en 氏は、 ~privacy~risk査定を寄せられた。 ◎ Lukasz Olejnik for the privacy risk assessment.