From 074785cea106179cb3305637055ab0a009ca74f2 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:42:52 -0500 Subject: initial commit --- files/ru/web/api/usb/getdevices/index.html | 63 ++++++++++++++++++++ files/ru/web/api/usb/index.html | 60 ++++++++++++++++++++ files/ru/web/api/usb/onconnect/index.html | 43 ++++++++++++++ files/ru/web/api/usb/ondisconnect/index.html | 43 ++++++++++++++ files/ru/web/api/usb/requestdevice/index.html | 82 +++++++++++++++++++++++++++ 5 files changed, 291 insertions(+) create mode 100644 files/ru/web/api/usb/getdevices/index.html create mode 100644 files/ru/web/api/usb/index.html create mode 100644 files/ru/web/api/usb/onconnect/index.html create mode 100644 files/ru/web/api/usb/ondisconnect/index.html create mode 100644 files/ru/web/api/usb/requestdevice/index.html (limited to 'files/ru/web/api/usb') diff --git a/files/ru/web/api/usb/getdevices/index.html b/files/ru/web/api/usb/getdevices/index.html new file mode 100644 index 0000000000..8b69fce817 --- /dev/null +++ b/files/ru/web/api/usb/getdevices/index.html @@ -0,0 +1,63 @@ +--- +title: USB.getDevices() +slug: Web/API/USB/getDevices +tags: + - API + - Method + - Reference + - USB + - WebUSB + - WebUSB API + - getDevices() +translation_of: Web/API/USB/getDevices +--- +

{{APIRef("WebUSB API")}}{{SeeCompatTable}}{{securecontext_header}}

+ +

Метод getDevices интерфейса {{DOMxRef("USB")}} возвращает {{JSxRef("Promise")}}, который разрешается с массивом {{DOMxRef("USBDevice")}} объектов сопряжённых подключённых устройств. Для информации о сопряжённых устройствах, смотрите {{DOMxRef("USB.requestDevice()")}}.

+ +

Синтаксис

+ +
USB.getDevices()
+ +

Параметры

+ +

Нет.

+ +

Возвращаемое значение

+ +

{{JSxRef("Promise")}}, который разрешается с массивом объектов {{DOMxRef("USBDevice")}}.

+ +

Пример

+ +

В следующем примере имена продуктов и серийные номера сопряжённых устройств выводятся в консоль. Для информации о сопряжённых устройствах, смотрите {{DOMxRef("USB.requestDevice","USB.requestDevice()")}}.

+ +
navigator.usb.getDevices()
+.then(devices => {
+  console.log("Total devices: " + devices.length);
+  devices.forEach(device => {
+    console.log("Product name: " + device.productName + ", serial number " + device.serialNumber);
+  });
+});
+ +

Спецификация

+ + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName("Web USB","#dom-usb-getdevices","getDevices")}}{{Spec2("Web USB")}}Изначальное определение.
+ +

Совместимость с браузерами

+ + + +

{{Compat("api.USB.getDevices")}}

diff --git a/files/ru/web/api/usb/index.html b/files/ru/web/api/usb/index.html new file mode 100644 index 0000000000..423ffc90da --- /dev/null +++ b/files/ru/web/api/usb/index.html @@ -0,0 +1,60 @@ +--- +title: USB +slug: Web/API/USB +tags: + - API + - Interface + - Reference + - USB + - WebUSB + - WebUSB API +translation_of: Web/API/USB +--- +

{{APIRef("WebUSB API")}}{{SeeCompatTable}}{{securecontext_header}}

+ +

Интерфейс USB WebUSB API представляет аттрибуты и методы для поиска и подключения USB устройств из WEB страницы.

+ +

Свойтсва

+ +

Нет.

+ +

Обработчики событий

+ +
+
{{domxref("USB.onconnect")}}
+
Обработчик событий вызывается всегда, когда ранее сопряжённое устройство подключается.
+
{{domxref("USB.ondisconnect")}}
+
Обработчик событий вызывается всегда, когда ранее сопряжённое устройство отключается.
+
+ +

Методы

+ +
+
{{domxref("USB.getDevices()")}}
+
Возвращает {{jsxref("Promise")}}, который разрешается массивов объектов {{domxref("USBDevice")}} сопряжённых устройств.
+
{{domxref("USB.requestDevice()")}}
+
Возвращает {{jsxref("Promise")}}, который разрешается экземпляром {{domxref("USBDevice")}}, если указаннное устройство найдено. Вызов этой функции запускает поток сопряжения агента пользователя.
+
+ +

Спецификация

+ + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('Web USB','#enumeration','USB')}}{{Spec2('Web USB')}}Изначальное определение.
+ +

Совместимость с браузерами

+ + + +

{{Compat("api.USB")}}

diff --git a/files/ru/web/api/usb/onconnect/index.html b/files/ru/web/api/usb/onconnect/index.html new file mode 100644 index 0000000000..3a7d64e234 --- /dev/null +++ b/files/ru/web/api/usb/onconnect/index.html @@ -0,0 +1,43 @@ +--- +title: USB.onconnect +slug: Web/API/USB/onconnect +tags: + - API + - Method + - Reference + - USB + - WebUSB + - WebUSB API + - onconnect +translation_of: Web/API/USB/onconnect +--- +

{{APIRef("WebUSB API")}}{{SeeCompatTable}}{{securecontext_header}}

+ +

Свойство onconnect интерфейса {{DOMxRef("USB")}} является обработчиком события, который вызывается всегда, когда сопряжённое устройство подключается.

+ +

Синтаксис

+ +
USB.onconnect = connectFunction
+ +

Спецификации

+ + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName("Web USB","#dom-usb-onconnect","onconnect")}}{{Spec2("Web USB")}}Изначальное определение.
+ +

Совместимость с браузерами

+ + + +

{{Compat("api.USB.onconnect")}}

diff --git a/files/ru/web/api/usb/ondisconnect/index.html b/files/ru/web/api/usb/ondisconnect/index.html new file mode 100644 index 0000000000..25dff131a0 --- /dev/null +++ b/files/ru/web/api/usb/ondisconnect/index.html @@ -0,0 +1,43 @@ +--- +title: USB.ondisconnect +slug: Web/API/USB/ondisconnect +tags: + - API + - Method + - Reference + - USB + - WebUSB + - WebUSB API + - ondisconnect +translation_of: Web/API/USB/ondisconnect +--- +

{{APIRef("WebUSB API")}}{{SeeCompatTable}}{{securecontext_header}}

+ +

Свойство ondisconnect интерфейса {{domxref("USB")}} является обработчиком события, который вызывается всегда, когда сопряжённое устройство отключается.

+ +

Синтаксис

+ +
USB.ondisconnect = disconnectFunction
+ +

Спецификации

+ + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName('Web USB','#dom-usb-ondisconnect','ondisconnect')}}{{Spec2('Web USB')}}Изначальное определение.
+ +

Совместимость с браузерами

+ + + +

{{Compat("api.USB.ondisconnect")}}

diff --git a/files/ru/web/api/usb/requestdevice/index.html b/files/ru/web/api/usb/requestdevice/index.html new file mode 100644 index 0000000000..bb162ad242 --- /dev/null +++ b/files/ru/web/api/usb/requestdevice/index.html @@ -0,0 +1,82 @@ +--- +title: USB.requestDevice() +slug: Web/API/USB/requestDevice +tags: + - API + - USB + - WebUSB + - WebUSB API + - getDevices() + - Определение + - метод +translation_of: Web/API/USB/requestDevice +--- +

{{APIRef("WebUSB API")}}{{SeeCompatTable}}{{securecontext_header}}

+ +

Метод requestDevice() интерфейса {{domxref("USB")}} возвращает {{jsxref("Promise")}}, возвращающий экземпляр {{domxref("USBDevice")}}, если необходимое устройство было найдено. Вызов этого метода начинает процесс соединения браузера с устройством.

+ +

Синтаксис

+ +
USB.requestDevice([filters])
+ +

Параметры

+ +
+
filters
+
Массив объектов, определяющих фильтры для устройств, к которым требуется подключиться. Каждый фильтр может содержать следующие свойства: +
    +
  • vendorId - ИД производителя (USB VID)
    • +
  • productId - ИД устройства USB PID
    • +
  • classCode - код класса функциональности устройства
    • +
  • subclassCode - код подкласса
    • +
  • protocolCode - код протокола
    • +
  • serialNumber - серийный номер
    • +
+
+
+ +

Возвращаемое значение

+ +

{{JSxRef("Promise")}}, возвращающий экземпляр {{DOMxRef("USBDevice")}}.

+ +

Пример

+ +

Этот пример запрашивает любое из перечисленных USB-устройств. Обратите внимание, указаны два разных PID. Оба присутствуют в списке фильтров для requestDevice(). При этом браузер покажет окно для выбора и подтверждения доступа к устройству. Только выбранное пользователем устройство будет передано в then().

+ +

Количество фильтров не определяет количество устройств, показываемых браузером. Например, если найдено только USB-устройство с product ID 0xa800, браузер отобразит только одно устройство. Но, если браузер определит два устройства, совпадающих с первым фильтром, и еще одно, совпадающее со вторым, будут показаны все три устройства.

+ +
const filters = [
+        {vendorId: 0x1209, productId: 0xa800},
+        {vendorId: 0x1209, productId: 0xa850}
+      ];
+navigator.usb.requestDevice({filters: filters})
+.then(usbDevice => {
+  console.log("Product name: " + usbDevice.productName);
+})
+.catch(e => {
+  console.log("There is no device. " + e);
+});
+
+ +

Спецификации

+ + + + + + + + + + + + + + +
СпецификацияСтатусКомментарий
{{SpecName("Web USB","#dom-usb-requestdevice-options-options","requestDevice")}}{{Spec2("Web USB")}}Изначальное определение.
+ +

Совместимость

+ + + +

{{Compat("api.USB.requestDevice")}}

-- cgit v1.2.3-54-g00ecf