На этой странице приведена полезная информация, которая нужна партнерам для планирования проекта быстрого подключения и интеграции системы.
Материалы и процесс быстрого подключения
В этом разделе приведены ссылки на общую информацию о маркетинге и процессах.
Маркетинг, брендинг и обмен сообщениями
Рекомендации по брендингу и обмену сообщениями можно найти на портале Partner Marketing Hub. Новым партнерам нужно подать заявку на доступ, а существующие партнеры могут получить доступ к контенту через аккаунт домена партнера.
Жизненный цикл проекта быстрого подключения
На странице Роли и обязанности системного интегратора вы найдете общее описание жизненного цикла проекта и обязанностей партнеров, интегрирующих Быстрое подключение в продукт.
Сертификация
Устройства, поддерживающие быстрое подключение, должны быть сертифицированы, прежде чем продукт можно будет продавать с этой функцией. В руководстве по сертификации устройств с поддержкой быстрого подключения описано, как подготовиться к сертификации и выполнить самотестирование.
В разделе часто задаваемых вопросов о сертификации вы найдете ответы на многие вопросы, в том числе о том, когда требуется полная сертификация или повторная сертификация.
Устройства, на которых реализованы или используются расширения Быстрого подключения, например переключатель звука, также должны быть сертифицированы. Для аудиопереключателя есть отдельное руководство по сертификации, в котором описаны этапы самотестирования и подготовки к сертификации в сторонней лаборатории.
Сторонние лаборатории могут сертифицировать быстрое подключение и переключение аудио по очереди. Список лабораторий и предлагаемых ими услуг по сертификации приведен на странице Отправка устройств в сторонние лаборатории.
Технические примечания
В этом разделе приведены некоторые технические примечания по реализации, которые помогут Партнерам в разработке и интеграции.
Как рекламировать другие протоколы наряду с быстрым подключением
Некоторые устройства могут поддерживать дополнительные функции, например Google Ассистента или Eddystone, для которых требуется дополнительное рекламное пространство. В таких случаях лучше всего использовать ротацию данных объявления. Однако объявления о быстром подключении должны по-прежнему показываться в течение интервала показа объявлений в соответствии с режимом обнаружения и режимом без обнаружения.
Ротация объявлений проверяется на этапе стороннего тестирования в рамках процесса сертификации. Чтобы избежать задержек, повторных проверок и дополнительных расходов, перед сертификацией проверьте все схемы ротации с помощью приложения Fast Pair Validator.
Сократите интервал подключения BLE
Чтобы улучшить производительность подключения GATT, поставщику рекомендуется сделать интервал подключения как можно короче. Ожидаемое оптимальное значение – 7,5 мс.Оно применяется к большинству искателей.
Объявление BLE и статус подключения гарнитуры
Передает ли гарнитура с поддержкой быстрого подключения идентификатор модели или данные аккаунта, зависит от режима обнаружения BR/EDR, а не от состояния подключения. Спецификации сервиса быстрого подключения доступны по ссылкам ниже.
- "Когда устройство поставщика находится в режиме обнаружения BR/EDR (то есть в режиме подключения), оно должно передавать данные об идентификаторе модели быстрого подключения по BLE". - link
- Когда устройство невидимо (то есть не находится в режиме подключения), поставщик должен объявлять данные в аккаунте для быстрого подключения – ссылка.
TxPower
Как указано в спецификации, Искатель оценивает расстояние по RSSI на основе заданного уровня TxPower. Расчетное расстояние – ключевой фактор, определяющий, будет ли показано уведомление.
Чтобы определить TxPower, выполните следующие действия:
- Измерьте фактическую мощность устройства с помощью телефона Android на расстоянии 1 м, а затем прибавьте к полученному значению 41 дБм.
- Включите это значение в объявление BLE.
- Включите это значение в отчет о самотестировании вместе с информацией о тестовом телефоне.
Как измерить и настроить TxPower с помощью приложения Validator
Приложение Validator позволяет вручную настроить TxPower на тестовом телефоне. Партнеры могут использовать этот тест, чтобы определить правильный уровень TxPower на тестируемом устройстве перед самотестированием или сертификацией.
Процедура измерения TxPower
Чтобы измерить TxPower с помощью приложения Validator, выполните следующие действия:
- Откройте приложение Validator на тестовом телефоне.
- Откройте меню в верхней части приложения:
- Поместите тестируемое устройство на расстоянии 1 метра от телефона и нажмите кнопку "Начать".
- Выберите тестируемое устройство из списка.
- Чтобы обновить список устройств, нажмите кнопку "ОТМЕНА", а затем снова нажмите кнопку "НАЧАТЬ".
- Переместите красную линию (мощность передачи) так, чтобы она едва касалась верхней границы желтой области.
- Нажмите кнопку "-1", чтобы переместить красную линию к желтой области.
- Нажмите кнопку "+1", чтобы переместить красную линию за пределы желтой области.
- Из-за помех красная линия может быть нестабильной. Если красная линия ведет себя хаотично, попробуйте перейти в место с меньшим количеством помех.
- Сохраните значение TxPower и обновите его как на тестируемом устройстве, так и в консоли устройства.
Уведомления о батарее
Как указано в спецификации, поставщик может включить в объявление информацию о батарее. Искатель решает, показывать ли уведомление о заряде батареи, в зависимости от типа: 0b0011 – показывать, 0b0100 – скрывать. Вот несколько рекомендаций о том, когда следует включать информацию о батарее в объявление и какой тип использовать:
- Включите информацию о батарее в объявление с уведомлением о показе батареи
0b0011не менее чем на 8 секунд, когда чехол открыт и оба наушника подключены. - Включите информацию о батарее в объявление со скрытым уведомлением о батарее
0b0100по крайней мере на 5 секунд, когда чехол закрыт и оба наушника находятся в нем. - Чтобы уведомления о заряде батареи показывались и скрывались своевременно, объявление должно отражать реальное состояние в течение двух секунд.
- Скрыть уведомление о батарее можно двумя способами:
- Если информация о батарее не включена в объявление, Искатель скрывает уведомление через некоторое время (сейчас установлено 20 секунд).
- Если в объявлении есть информация о батарее и уведомление о скрытии батареи
0b0100, Искатель скрывает уведомление сразу после получения объявления.
- Если в чехле находится только один наушник, то информацию о батарее можно не включать в объявление.
- Информацию о батарее можно не включать в объявление, когда наушники извлекаются из чехла или помещаются в него.
- Чтобы предотвратить отслеживание, поставщик должен включать в объявление необработанные данные о батарее только при необходимости, а не постоянно.
Реализация должна быть описана в результатах самотестирования для сертификации.
Как включить ведение журнала быстрого подключения
Перед отладкой убедитесь, что на устройстве включен журнал отслеживания Bluetooth HCI. Чтобы важные журналы быстрого подключения не были отредактированы из соображений безопасности, присоединитесь к Google Группе для тестирования быстрого подключения (fast-pair-partner-test@googlegroups.com), используя тестовые аккаунты Google.
Чтобы добавить сообщения о быстром подключении в журналы отладки, выполните следующую команду:
$ 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