From 61a2d8571d1160c43201b2b51360de6977795c94 Mon Sep 17 00:00:00 2001 From: Yeji Choi <61399588+yechoi42@users.noreply.github.com> Date: Thu, 27 May 2021 12:05:36 +0900 Subject: update proximity_events ko-doc (#971) * Add {{Deprecated_Header}}, Delete compat-table and some translation * [FIX] conflicts Co-authored-by: yechoi --- files/ko/web/api/proximity_events/index.html | 87 +++++++++++++--------------- 1 file changed, 41 insertions(+), 46 deletions(-) (limited to 'files') diff --git a/files/ko/web/api/proximity_events/index.html b/files/ko/web/api/proximity_events/index.html index b618054ce8..c0a58ec4c6 100644 --- a/files/ko/web/api/proximity_events/index.html +++ b/files/ko/web/api/proximity_events/index.html @@ -1,56 +1,51 @@ --- -title: Proximity +title: Proximity Events slug: Web/API/Proximity_Events translation_of: Web/API/Proximity_Events original_slug: WebAPI/Proximity +tags: + - API + - Experimental + - Proximity Events + - Reference + - Deprecated --- -

{{ SeeCompatTable }}

-

Summary

-

근접 이벤트는 사용자가 디바이스에 가까이 갔을때를 알 수 있는 간단한 벙법이다.

-

예를 들어,  사용자가 전화가 걸려왔을 때 디바이스에 귀를 가까이 하면, 근접 이벤트들은 스마트폰의 화면이 꺼지게 하여 이러한 변화에 대응할 수 있게 해준다.

-
-

Note: 당연히 이 API는 근접 센서를 가진 장치를 필요로 하며, 이 근접 센서는 대게 모바일 다비이스들에서만 이용 가능하다. 근접 센서가 없는 장치들에서는 근접 이벤트들을 지원할 수는 있을 지 몰라도 해당 이벤트들은 절대 발생하지 않을 것이다.

+
{{DefaultAPISidebar("Proximity Events")}}{{Deprecated_Header}}
+
+

Warning

+

The Proximity Events APIs are not supported by any current major browser, and should not be used. This page is provided for historical interest.

-

Proximity Events

-

다비이스 근접 센서가 장치와 대상 사이의 변화를 감지했을 때, 센서는 그  변화를 브라우저에게 알린다. 브라우저는 그 알림을 받으면 그 변화에 대해 {{domxref("DeviceProximityEvent")}} 이벤트를 발생시킨다. 그리고 더 대략적인 변화(more rough change)를 알리기 위해  {{domxref("UserProximityEvent")}} 이벤트를 발생시킨다.

-

window object 레벨에서  {{domxref("EventTarget.addEventListener","addEventListener")}} 메소드 ({{event("deviceproximity")}} 또는 {{event("userproximity")}} 이벤트명) 를 이용하여 근접 이벤트를 전달받을 수 있다. 또한 {{domxref("window.ondeviceproximity")}} 또는 {{domxref("window.onuserproximity")}} 프로퍼티에 이벤트 핸들러를 붙이는 방법으로도 이벤트를 전달받을 수 있다.

-

일단 이벤트가 전달되면, 그 이벤트 오브젝트는 다음과 같은 여러 종류의 정보에 접근할 수 있게 해준다:

+ +

근접 이벤트는 사용자가 디바이스에 가까이 갔을 때를 알 수 있는 간단한 방법이다. 예를 들어, 사용자에게 전화가 걸려왔을 때 디바이스에 귀를 가까이하면, 근접 이벤트들은 스마트폰의 화면이 꺼지게 하여 이러한 변화에 대응할 수 있게 해준다.

+ +

근접 링크는 두 가지가 있다. (문서를 확인하려먼 링크를 참고하시오.):

-

Example

-
window.addEventListener('userproximity', function(event) {
-  if (event.near) {
-    // let's power off the screen
-    navigator.mozPower.screenEnabled = false;
-  } else {
-    // Otherwise, let's power on the screen
-    navigator.mozPower.screenEnabled = true;
-  }
-});
-

Specifications

+ +

두 가지의 차이점은 {{domxref("UserProximityEvent")}} 은 유저가 "가깝다"고 여겨질 때 단순히 true라고 알려주는 반면에, {{domxref("DeviceProximityEvent")}}는 근처 객체의 실제 거리 추정치를 제공한다.

+ +
+

Note: 당연히 이 API는 근접 센서를 가진 장치를 필요로 하며, 이 근접 센서는 대게 모바일 다비이스들에서만 이용 가능하다. 근접 센서가 없는 장치들에서는 근접 이벤트들을 지원할 수는 있을 지 몰라도 해당 이벤트들은 절대 발생하지 않을 것이다.

+
+ + +

Specifications

+ - - - - - - - - - - - - - - + + + + + + + + + + + + + +
SpecificationStatusComment
{{ SpecName('Proximity Events', '', 'Proximity Events') }}{{ Spec2('Proximity Events') }}Initial specification
SpecificationStatusComment
{{ SpecName('Proximity Events', '', 'Proximity Events') }}{{ Spec2('Proximity Events') }}Initial specification
- -

See also

- -- cgit v1.2.3-54-g00ecf