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

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

Материалы и процесс быстрого сопряжения

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

Маркетинг, брендинг и коммуникация

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

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

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

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

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

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

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

Сторонние лаборатории могут последовательно сертифицировать устройства Fast Pair и аудиокоммутаторы. Список лабораторий, предоставляющих какие услуги по сертификации, можно найти на странице « Отправка устройств в сторонние лаборатории» .

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

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

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

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

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

Сокращение интервала соединения BLE

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

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

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

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

TxPower

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

Процесс определения мощности передачи (TxPower) выглядит следующим образом:

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

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

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

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

Для измерения мощности передачи с помощью приложения Validator:

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

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

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

  1. Включайте информацию о состоянии батареи в рекламное сообщение с помощью команды show battery notification 0b0011 в течение как минимум 8 секунд, когда чехол открыт и оба наушника находятся в док-станции.
  2. Включайте информацию о батарее в рекламное объявление с помощью команды hide battery notification 0b0100 как минимум на 5 секунд, когда чехол закрыт и оба наушника находятся в док-станции.
  3. Чтобы уведомления о состоянии батареи отображались или скрывались мгновенно, рекламное объявление должно отражать реальное состояние в течение 2 секунд.
  4. Есть 2 способа скрыть уведомление о состоянии батареи:
    1. Прекратите включать информацию о состоянии батареи в рекламное объявление, Seeker скрывает уведомление через некоторое время (сейчас это установлено на 20 секунд).
    2. Включите информацию о батарее в рекламное объявление с помощью команды hide battery notification 0b0100 ; Seeker скроет уведомление сразу после получения рекламного объявления.
  5. Включение информации о состоянии батареи в рекламное объявление является необязательным, если в чехле подключен только один наушник, независимо от того, открыт чехол или закрыт.
  6. Включение информации о состоянии батареи в рекламное сообщение при извлечении наушников из чехла или установке их в чехол является необязательным.
  7. Чтобы предотвратить отслеживание, поставщик услуг должен включать необработанные данные о состоянии батареи в рекламное объявление только при необходимости (а не постоянно).

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

Как включить быструю запись в лог-файлы сопряжения

Перед началом отладки убедитесь, что на устройстве включено отслеживание событий Bluetooth HCI . Кроме того, чтобы предотвратить удаление важных журналов Fast Pair по соображениям безопасности, присоединитесь к группе Google Fast Pair Partner Test ( fast-pair-partner-test@googlegroups.com ), используя свои тестовые учетные записи Google.

Чтобы записывать сообщения 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