Материалы для быстрой пары и технические примечания

На этой странице описана полезная информация, необходимая партнерам как для планирования проекта Fast Pair, так и для системной интеграции.

Материалы и процесс быстрой пары

В этом разделе представлены ссылки на общую маркетинговую и технологическую информацию.

Маркетинг, брендинг и обмен сообщениями

Посетите наш центр партнерского маркетинга , чтобы получить рекомендации по брендингу и обмену сообщениями. Новым партнерам необходимо подать заявку на доступ, в то время как существующие партнеры уже могут получить доступ к контенту через свою учетную запись партнерского домена.

Жизненный цикл проекта Fast Pair

См. страницу «Роли и обязанности системного интегратора (SI)» для получения общего описания жизненного цикла проекта и обязанностей партнеров, интегрирующих Fast Pair в продукт.

Процесс сертификации

Устройства, поддерживающие быстрое соединение, должны быть сертифицированы , прежде чем продукт может быть продан с этой функцией. Руководство по сертификации Fast Pair описывает, как подготовиться к сертификации и выполнить самотестирование перед сертификацией.

Часто задаваемые вопросы по сертификации охватывают множество общих вопросов, включая общее описание того, когда требуется полная сертификация (или повторная сертификация).

Устройства, реализующие или использующие расширения Fast Pair, такие как аудиопереключатель , также должны быть сертифицированы . Для аудиопереключателя имеется отдельное руководство по сертификации , описывающее этапы самотестирования и подготовку к сертификации в сторонней лаборатории.

Сторонние лаборатории могут последовательно сертифицировать Fast Pair и Audio Switch. См. страницу «Доставка устройств в сторонние лаборатории», чтобы узнать, какие лаборатории предлагают какие услуги по сертификации.

Технические примечания

В этом разделе описаны некоторые технические замечания по реализации, которые помогут партнерам в разработке и интеграции.

Как рекламировать другие протоколы наряду с быстрым соединением

Некоторые устройства могут захотеть поддерживать дополнительные функции помимо Fast Pair, такие как Google Assistant или Eddystone, которые требуют дополнительного рекламного места. Ротация рекламных данных — лучший вариант в таких случаях. Однако рекламные объявления Fast Pair по-прежнему должны рекламироваться в течение рекламного интервала в соответствии с режимом обнаружения и режимом отсутствия обнаружения .

Ротация рекламы проверяется на этапе стороннего тестирования процесса сертификации. Обязательно проверяйте все схемы ротации с помощью приложения Fast Pair Validator перед сертификацией, чтобы избежать возможных задержек сертификации, повторного тестирования и затрат.

Сократить интервал подключения BLE

Ожидается, что для повышения производительности подключения GATT поставщик сделает интервал подключения как можно короче. Ожидаемое оптимальное значение составляет 7,5 мс, которое применяется к большинству Искателей.

Объявление BLE и состояние подключения гарнитуры

Будет ли гарнитура Fast Pair объявлять идентификатор модели или данные учетной записи, зависит от режима обнаружения BR/EDR гарнитуры, а не от состояния подключения или отключения. См. спецификацию услуги быстрого сопряжения по ссылкам ниже:

  • «Когда устройство поставщика находится в режиме обнаружения BR/EDR (то есть в режиме сопряжения), оно должно рекламировать данные идентификатора модели быстрого соединения через BLE». - связь
  • «Если невозможно обнаружить (то есть не в режиме сопряжения), Провайдер должен рекламировать данные учетной записи Fast Pair» — ссылка

TxPower

Как определено вспецификации , Seeker оценивает расстояние по RSSI на основе заданного уровня TxPower. Предполагаемое расстояние является ключевым фактором, определяющим, показывать ли уведомление или нет.

Процесс определения TxPower:

  1. Измерьте фактическую мощность устройства с помощью телефона Android на расстоянии 1 метр, а затем прибавьте к этому 41 дБм.
  2. Включите это значение в объявление BLE.
  3. Включите это значение в информацию о тестируемом телефоне в отчет самопроверки.

Измерьте и установите TxPower с помощью приложения Validator

Приложение Validator обеспечивает проверку ручной настройки TxPower до нужного уровня на тестируемом устройстве. Партнеры могут использовать этот тест, чтобы определить правильный уровень мощности TxPower на своем тестируемом устройстве перед самотестированием или сертификацией.

Процедура измерения мощности передачи

Чтобы измерить мощность TxPower с помощью приложения Validator:

  1. Откройте приложение Validator на тестируемом устройстве.
  2. Откройте точечное меню вверху приложения:
    Тест называется «Инструмент калибровки уровня мощности Tx».
  3. Поместите тестируемое устройство на расстоянии 1 метра от телефона и нажмите кнопку «СТАРТ».
    На тестовой странице целевое расчетное расстояние отображается желтым цветом.
  4. Выберите тестируемое устройство из списка устройств.
    Устройства перечислены по их MAC-адресам.
    1. Вы можете обновить список устройств, нажав кнопку «ОТМЕНА» и повторно выбрав кнопку «СТАРТ».
  5. Отрегулируйте красную линию (представляющую TxPower) так, чтобы она едва касалась верхней части желтой области.
    При правильной настройке красная линия окажется на самом верху желтой области.
    1. Используйте кнопку «-1», чтобы переместить красную линию в сторону желтой области.
    2. Используйте кнопку «+1», чтобы отодвинуть красную линию от желтой области.
    3. Помехи сигнала могут сделать красную линию нестабильной. Если красная линия ведет себя хаотично, попробуйте перейти в место с меньшими помехами для сигнала.
  6. Сохраните значение TxPower и обновите его как в тестируемом устройстве, так и в консоли устройства.
    Номер отображается в верхней части экрана.

Уведомления о батарее

Как определено в спецификации , Поставщик может включать в рекламу информацию о батарее. Искатель решает, показывать или скрывать уведомление о батарее в зависимости от типа: 0b0011, чтобы показать уведомление о батарее, или 0b0100, чтобы скрыть его. Вот несколько рекомендаций о том, когда включать информацию о батарее в рекламу и какой тип батареи следует использовать:

  1. Включите информацию о батарее в рекламу с отображением уведомления о батарее 0b0011 в течение как минимум 8 секунд, когда чехол открыт и оба наушника состыкованы.
  2. Включите информацию о батарее в рекламу со скрытым уведомлением о батарее 0b0100 как минимум на 5 секунд, когда чехол закрыт и оба наушника состыкованы.
  3. Чтобы обеспечить быстрое отображение или скрытие уведомлений о заряде батареи, реклама должна отражать реальное состояние в течение 2 секунд.
  4. Есть 2 способа скрыть уведомление о заряде батареи:
    1. Перестаньте включать в рекламу информацию о батарее, Искатель через некоторое время скроет уведомление (которое пока установлено на 20 секунд).
    2. Включите информацию о батарее в рекламу с помощью параметра «Скрыть уведомление о батарее» 0b0100 , Искатель скроет уведомление сразу после получения рекламы.
  5. Включение информации о батарее в рекламу не является обязательным, если при открытом или закрытом корпусе пристыкован только один наушник.
  6. Необязательно включать информацию о батарее в рекламу, когда наушники вынимаются из чехла или прикрепляются к чехлу.
  7. Чтобы предотвратить отслеживание, Поставщик должен включать в рекламу необработанные данные об аккумуляторе только при необходимости (не всегда).

Реализация должна быть описана в результатах самотестирования для сертификации.

Как включить ведение журнала быстрой пары

Перед отладкой убедитесь, что на устройстве включен журнал отслеживания Bluetooth HCI .

Чтобы записать сообщения Fast Pair в журналы отладки, запустите:

$ adb logcat -G 16M
$ adb shell setprop log.tag.NearbyMessages VERBOSE
$ adb shell setprop log.tag.NearbyDiscovery VERBOSE
$ adb shell setprop log.tag.FastPair VERBOSE

Google рекомендует выполнять предыдущие команды при каждой загрузке.

Как извлечь журнал отладки

Запустите $ adb bugreport чтобы создать zip-файл, который должен содержать все данные. Создание zip-файла может занять несколько минут.

В зависимости от версии Android выполните одну из следующих команд, чтобы получить btsnoop_hic.log :

  • Для Android 8.x и выше: shell $ adb pull data/misc/bluetooth/logs logs
  • Для Android 7.x: shell $ adb pull sdcard/btsnoop_hci.log