Auf dieser Seite werden nützliche Informationen beschrieben, die Partner sowohl für die Projektplanung beim schnellen Pairing als auch für die Systemintegration benötigen.
Materialien und Verfahren für schnelles Pairing
Dieser Abschnitt enthält Links zu allgemeinen Marketing- und Prozessinformationen.
Marketing, Branding und Werbebotschaften
In unserem Marketing-Hub für Partner findest du Anleitungen zu Branding und Botschaften. Neue Partner müssen den Zugriff beantragen, während bestehende Partner bereits über ihr Partnerdomain-Konto auf die Inhalte zugreifen können.
Projektlebenszyklus für schnelles Pairing
Auf der Seite Rollen und Verantwortlichkeiten des Systemintegrators (SI) finden Sie eine allgemeine Beschreibung des Projektlebenszyklus und der Verantwortlichkeiten für Partner, die schnelles Pairing in ein Produkt integrieren.
Zertifizierung
Geräte, die schnelles Pairing implementieren, müssen zertifiziert sein, bevor ein Produkt mit dieser Funktion vermarktet werden kann. In der Zertifizierungsrichtlinie für schnelles Pairing wird beschrieben, wie Sie sich auf die Zertifizierung vorbereiten und Selbsttests vor der Zertifizierung durchführen.
In den FAQs zur Zertifizierung finden Sie Antworten auf häufig gestellte Fragen, einschließlich einer allgemeinen Beschreibung, wann eine vollständige oder erneute Zertifizierung erforderlich ist.
Geräte, die „Schnelles Pairing“ implementieren oder verwenden, z. B. den Audio-Wechsel, müssen ebenfalls zertifiziert sein. Es gibt eine [separate Zertifizierungsrichtlinie][ASGuideLink] für „Audio Switch“, in der die Schritte zum Selbsttest beschrieben und die Vorbereitung auf die Drittanbieter-Lab-Zertifizierung beschrieben wird.
Labs von Drittanbietern können „Schnelles Pairing“ und „Audio-Wechsel“ sequenziell zertifizieren lassen. Auf der Seite Geräte an Drittanbieter-Labs senden erfahren Sie, für welche Labs welche Zertifizierungsdienste angeboten werden.
Technische Hinweise
In diesem Abschnitt werden einige Hinweise zur technischen Implementierung beschrieben, die Partnern bei der Entwicklung und Integration helfen.
Wie Sie neben dem schnellen Pairing weitere Protokolle bewerben
Einige Geräte möchten zusätzlich zu „Schnelles Pairing“ zusätzliche Funktionen wie Google Assistant oder Eddystone unterstützen, für die zusätzlicher Platz in der Anzeige benötigt wird. In diesen Fällen ist die Rotation der Anzeigendaten die beste Option. Die Anzeigen für schnelles Pairing müssen jedoch weiterhin im Advertising-Intervall gemäß dem Modus „Sichtbar“ und dem Modus „Nicht sichtbar“ beworben werden.
Die Werberotation wird in der Testphase durch Drittanbieter des Zertifizierungsprozesses getestet. Prüfe vor der Zertifizierung alle Rotationsschemata mit der App „Fast Pair Validator“, um mögliche Verzögerungen, erneute Tests und Kosten zu vermeiden.
BLE-Verbindungsintervall verkürzen
Um die Leistung beim Erstellen von GATT-Verbindungen zu verbessern, wird vom Anbieter erwartet, das Verbindungsintervall so kurz wie möglich zu halten. Der erwartete optimale Wert ist 7,5 ms und wird auf die meisten Suchenden angewendet.
BLE-Werbung und Headset-Verbindungsstatus
Ob ein schnelles Pairing für ein Headset die Modell-ID oder Kontodaten ankündigt, hängt vom BR/EDR-Erkennungsmodus des Headsets ab, nicht vom Status „Verbunden“ oder „Nicht verbunden“. Weitere Informationen finden Sie unter den folgenden Links in der Dienstspezifikation für schnelles Pairing:
- „Wenn das Anbietergerät in BR/EDR sichtbar ist (d. h. im Kopplungsmodus), werden Modell-ID-Daten für schnelles Pairing über BLE beworben.“ - Link
- „Wenn der Anbieter nicht sichtbar ist (d. h. nicht im Kopplungsmodus), wird er für Kontodaten für schnelles Pairing werben. Link
TxPower
Wie in der Spezifikation definiert, schätzt der Seeker die Entfernung anhand des RSSI basierend auf dem angegebenen TxPower-Level. Die geschätzte Entfernung ist der Schlüsselfaktor dafür, ob die Benachrichtigung angezeigt wird oder nicht.
So ermitteln Sie TxPower:
- Messen Sie die tatsächliche Ausgabe des Geräts mit einem Android-Smartphone in einem Meter Entfernung und addieren Sie 41 dBm.
- Nehmen Sie diesen Wert in das BLE-Advertising auf.
- Fügen Sie diesen Wert zusammen mit den Informationen zum Testtelefon in den Selbsttestbericht ein.
TxPower mit der Validator App messen und einrichten
Mit der Validator App können Sie einen Test durchführen, um TxPower manuell auf das richtige Niveau einer DUT einzustellen. Partner können diesen Test verwenden, um vor dem Selbsttest oder der Zertifizierung die richtige TxPower-Ebene auf ihrer DUT zu bestimmen.
TxPower-Messverfahren
So messen Sie TxPower mit der Validator App:
- Öffnen Sie die Validator App auf der DUT.
- Öffnen Sie das Dreipunkt-Menü oben in der App:
- Platzieren Sie die DUT einen Meter vom Smartphone entfernt und tippen Sie auf die Schaltfläche „STARTEN“.
- Wählen Sie das DUT aus der Geräteliste aus.
- Sie können die Geräteliste aktualisieren, indem Sie auf die Schaltfläche „ABBRECHEN“ tippen und noch einmal die Schaltfläche „START“ auswählen.
- Passen Sie die rote Linie (für TxPower) an, bis sie den oberen Rand des gelben Bereichs kaum berührt.
- Verschieben Sie die rote Linie mit der Schaltfläche „-1“ in den gelben Bereich.
- Verwenden Sie die Schaltfläche „+1“, um die rote Linie vom gelben Bereich wegzubewegen.
- Signalstörungen können die rote Linie instabil machen. Wenn sich die rote Linie unregelmäßig verhält, versuchen Sie, sich in einen Bereich mit weniger Signalstörungen zu begeben.
- Speichern Sie den TxPower-Wert und aktualisieren Sie ihn sowohl in der DUT als auch in der Gerätekonsole.
Akkubenachrichtigungen
Wie in der Spezifikation definiert, kann der Dienstleister Informationen über den Akku in die Werbung aufnehmen. Der Seeker entscheidet, ob die Akkubenachrichtigung je nach Typ ein- oder ausgeblendet wird: entweder 0b0011, um die Akkubenachrichtigung anzuzeigen, oder 0b0100, um sie auszublenden. Hier findest du einige Richtlinien, wann du Informationen zum Akku in die Werbung aufnehmen und welche Art von Daten verwendet werden sollten:
- Nimm die Informationen zum Akku in die Anzeige mit der Anzeige der Akkubenachrichtigung
0b0011
für mindestens 8 Sekunden auf, wenn das Case geöffnet und beide Kopfhörer angedockt sind. - Nimm die Informationen zum Akku in die Anzeige mit der Benachrichtigung „Akku ausblenden“
0b0100
für mindestens 5 Sekunden auf, wenn das Case geschlossen und beide Kopfhörer angedockt sind. - Damit Akkubenachrichtigungen ein- oder ausgeblendet werden können, sollte sie innerhalb von zwei Sekunden den tatsächlichen Status widerspiegeln.
- Es gibt zwei Möglichkeiten, die Akkubenachrichtigung auszublenden:
- Wenn die Anzeige keine Akkuinformationen mehr enthält, blendet der Seeker die Benachrichtigung nach einer gewissen Zeit aus (vorerst auf 20 Sekunden festgelegt).
- Nimm die Informationen zum Akku mit der Benachrichtigung
0b0100
zum Ausblenden des Akkus in die Anzeige auf. Der Seeker blendet die Benachrichtigung sofort nach Erhalt der Anzeige aus.
- Es ist optional, Informationen zum Akku in die Anzeige aufzunehmen, wenn bei geöffnetem oder geschlossenem Case nur ein Kopfhörer angedockt ist.
- Es ist optional, Informationen zum Akku in die Werbung aufzunehmen, wenn die Kopfhörer aus dem Case entfernt oder am Case angedockt werden.
- Um ein Tracking zu verhindern, sollte der Dienstleister nur bei Bedarf Rohdaten des Akkus in die Werbung aufnehmen und nicht immer.
Die Implementierung sollte im Ergebnis des Selbsttests beschrieben werden.
Logging für schnelles Pairing aktivieren
Aktivieren Sie vor dem Debugging das Bluetooth HCI-Snoop-Protokoll auf dem Gerät.
Führen Sie folgenden Befehl aus, um Meldungen über schnelles Pairing in Ihren Fehlerbehebungsprotokollen zu erfassen:
$ 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 empfiehlt, die vorherigen Befehle bei jeder Startsequenz auszuführen.
Fehlerbehebungsprotokoll extrahieren
Führen Sie $ adb bugreport
aus, um eine ZIP-Datei zu generieren, die alle Daten enthalten sollte. Das Erstellen der ZIP-Datei kann einige Minuten dauern.
Führen Sie je nach Android-Version einen der folgenden Befehle aus, um btsnoop_hic.log
abzurufen:
- Für Android 8.x und höher:
shell $ adb pull data/misc/bluetooth/logs logs
- Für Android 7.x:
shell $ adb pull sdcard/btsnoop_hci.log