google / libhidtelephony

LibHIDTelephony

"This is not an officially supported Google product"

This library aims to support standard USB call control functions based on the USB HID specification defined by USB.org on top of the WebHID API.

Installation

Use the package manager npm to install the dependencies.

npm install

NOTE: This library isn't published to npm yet

Usage

Start A Local Testing Web Application

npm start

You can use the application to verify some simple telephony functionalities of a HID telephony device.

Pack The Testing App

npm run pack_app

The codes should be compiled into ./dist, that you can directly copy to the host.

Pack Only The Library

npm run pack

The codes should be compiled into ./dist as libtelephony.js.

More

Please refer to the package.json for more commands you can run.

Source Code Headers

Every file containing source code must include copyright and license information. This includes any JS/CSS files that you might be serving out to browsers. (This is to help well-intentioned people avoid accidental copying that doesn't comply with the license.)

Apache header:

Copyright 2021 Google LLC

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

libhidtelephony's Issues

How to store connection state after page reload?

Hi, I'm using this lib and just have some confuse.

Expected Behavior

Is there any good way that I can save last connection selection? So that the user don not need to select again after reload page.

Actual Behavior

Every time I call the TelephonyDeviceManager.create, the browser dialog for hid device select will be shown.

Specifications

• Version: the latest main branch
• Platform: MacOS, Chrome Browser

Cannot get the correct inputReport when change the mute status by USB device.

I just test two device and all of them get wrong. When I click the mute button in USB device.

Expected Behavior

The report should be 'Received: PhoneMute(true) as type ToggleButton' when I mute it and 'Received: PhoneMute(false) as type ToggleButton' when I unmute.

Actual Behavior

For one device Poly 3320, whatever I mute or unmute, I just get two log at the same time
Received: PhoneMute(true) as type ToggleButton
Received: PhoneMute(false) as type ToggleButton
The other device Jabra Evolve2 40, I can got nothing when unmute, When mute, I can geo two log
Received: PhoneMute(true) as type ToggleButton
Received: PhoneMute(false) as type ToggleButton

Steps to Reproduce the Problem

1. run the example page
2. click start and connect to device
3. click off-hook 1
4. press the mute/unmute button by device

Specifications

• Version: master
• Platform: MacOS Chrome