Cette page fournit des informations utiles aux partenaires pour la planification de projets d'Association express et l'intégration de systèmes.
Matériel et processus d'Association express
Cette section fournit des liens vers des informations générales sur le marketing et les processus.
Marketing, branding et messagerie
Consultez notre portail marketing pour les partenaires pour obtenir des conseils sur l'image de marque et les messages. Les nouveaux partenaires doivent demander l'accès, tandis que les partenaires existants peuvent déjà accéder au contenu via leur compte de domaine de partenaire.
Cycle de vie d'un projet d'association express
Consultez la page Rôles et responsabilités de l'intégrateur système pour obtenir une description générale du cycle de vie du projet et des responsabilités des partenaires qui intègrent l'Association express à un produit.
Processus de certification
Les appareils implémentant l'Association express doivent être certifiés avant qu'un produit puisse être commercialisé avec cette fonctionnalité. Les consignes de certification Fast Pair décrivent comment se préparer à la certification et effectuer des tests automatiques de précertification.
Les questions fréquentes sur la certification couvrent un large éventail de questions courantes, y compris une description générale des cas où une certification complète (ou une recertification) est requise.
Les appareils qui implémentent ou utilisent des extensions d'Association express, comme le switch audio, doivent également être certifiés. La commutation audio dispose de consignes de certification distinctes décrivant les étapes d'autotest et la préparation à la certification par un laboratoire tiers.
Les laboratoires tiers peuvent certifier l'Association express et le switch audio de manière séquentielle. Consultez la page Expédier des appareils à des laboratoires tiers pour savoir quels laboratoires proposent quels services de certification.
Notes techniques
Cette section décrit quelques notes d'implémentation technique pour aider les partenaires à développer et à intégrer.
Annoncer d'autres protocoles en plus de l'Association express
Certains appareils peuvent prendre en charge des fonctionnalités supplémentaires en plus de l'Association express, telles que l'Assistant Google ou Eddystone, qui nécessitent un espace publicitaire supplémentaire. La rotation des données publicitaires est la meilleure option dans ces cas. Toutefois, les annonces d'Association express doivent toujours être diffusées dans l'intervalle de diffusion, conformément au mode visible et au mode non visible.
La rotation des annonces est testée lors de la phase de test par un tiers du processus de certification. Veillez à vérifier tous les schémas de rotation avec l'application Fast Pair Validator avant la certification pour éviter d'éventuels retards, de nouveaux tests et des coûts supplémentaires.
Raccourcir l'intervalle de connexion BLE
Pour améliorer les performances de création de la connexion GATT, le fournisseur doit réduire au maximum l'intervalle de connexion. La valeur optimale attendue est de 7,5 ms, ce qui est appliqué à la plupart des Seekers.
Annonce BLE et état de la connexion du casque
Le fait qu'un casque Association express annonce l'ID de modèle ou les données du compte dépend du mode de détection BR/EDR du casque, et non de l'état connecté ou déconnecté. Consultez les spécifications du service d'Association express en cliquant sur les liens ci-dessous :
- Lorsque l'appareil du fournisseur est visible en mode BR/EDR (c'est-à-dire en mode association), il doit annoncer les données d'ID de modèle de l'Association express via BLE. - link
- Lorsqu'il n'est pas visible (c'est-à-dire qu'il n'est pas en mode association), le fournisseur doit annoncer les données du compte Association express – lien
TxPower
Comme défini dans la spécification, le Seeker estime la distance par le RSSI en fonction du niveau TxPower donné. La distance estimée est le facteur clé pour déterminer s'il faut afficher ou non la notification.
Le processus de détermination de TxPower est le suivant :
- Mesurez la sortie réelle de l'appareil à l'aide d'un téléphone Android à une distance d'un mètre, puis ajoutez 41 dBm à cette valeur.
- Incluez cette valeur dans l'annonce BLE.
- Incluez cette valeur avec les informations sur le téléphone de test dans le rapport de test automatique.
Mesurer et définir la puissance de transmission avec l'application Validator
L'application Validator fournit un test permettant d'ajuster manuellement la puissance de transmission au niveau approprié sur un téléphone de test. Les partenaires peuvent utiliser ce test pour déterminer le niveau TxPower approprié sur leur DUT avant le test automatique ou la certification.
Procédure de mesure de la puissance d'émission
Pour mesurer la puissance de transmission avec l'application Validator :
- Ouvrez l'application Validator sur le téléphone de test.
- Ouvrez le menu à trois points en haut de l'application :
- Placez l'appareil testé à un mètre du téléphone, puis appuyez sur le bouton "START" (DÉMARRER).
- Sélectionnez le DUT dans la liste des appareils.
- Vous pouvez actualiser la liste des appareils en appuyant sur le bouton "ANNULER", puis en sélectionnant à nouveau le bouton "DÉMARRER".
- Ajustez la ligne rouge (représentant TxPower) jusqu'à ce qu'elle touche à peine le haut de la zone jaune.
- Utilisez le bouton "-1" pour déplacer la ligne rouge vers la région jaune.
- Utilisez le bouton "+1" pour éloigner la ligne rouge de la région jaune.
- Les interférences de signal peuvent rendre la ligne rouge instable. Si la ligne rouge se comporte de manière irrégulière, essayez de vous déplacer vers une zone où les interférences de signal sont moins importantes.
- Enregistrez la valeur TxPower et mettez-la à jour à la fois dans l'appareil testé et dans la Device Console.
Notifications concernant la batterie
Comme défini dans la spécification, le fournisseur peut inclure des informations sur la batterie dans l'annonce. Le chercheur décide d'afficher ou de masquer la notification de batterie en fonction du type, soit 0b0011 pour afficher la notification de batterie, soit 0b0100 pour la masquer. Voici quelques consignes pour savoir quand inclure les informations sur la batterie dans l'annonce et quel type d'informations utiliser :
- Incluez les informations sur la batterie dans l'annonce avec la notification d'affichage de la batterie
0b0011pendant au moins huit secondes lorsque l'étui est ouvert et que les deux écouteurs sont insérés. - Incluez les informations sur la batterie dans l'annonce avec la notification de masquage de la batterie
0b0100pendant au moins cinq secondes lorsque l'étui est fermé et que les deux écouteurs sont insérés. - Pour afficher ou masquer les notifications de batterie de manière réactive, l'annonce doit refléter l'état réel dans un délai de deux secondes.
- Il existe deux façons de masquer la notification de batterie :
- Arrêtez d'inclure les informations sur la batterie dans l'annonce. Le chercheur masque la notification après un certain temps (qui est actuellement défini sur 20 secondes).
- Incluez les informations sur la batterie dans l'annonce avec la notification de masquage de la batterie
0b0100. Le chercheur masque la notification dès qu'il reçoit l'annonce.
- Il est facultatif d'inclure les informations sur la batterie dans l'annonce si un seul écouteur est inséré lorsque l'étui est ouvert ou fermé.
- Il est facultatif d'inclure les informations sur la batterie dans l'annonce lorsque les écouteurs sont retirés de l'étui ou placés dans l'étui.
- Pour empêcher le suivi, le fournisseur ne doit inclure les données brutes de la batterie dans l'annonce que si nécessaire (pas tout le temps).
L'implémentation doit être décrite dans le résultat du test automatique pour la certification.
Activer la journalisation de l'Association express
Assurez-vous d'avoir activé le journal de surveillance du trafic HCI Bluetooth sur l'appareil avant de procéder au débogage. De plus, pour éviter que les journaux d'Association express clés ne soient masqués pour des raisons de sécurité, rejoignez le groupe Google de test des partenaires d'Association express (fast-pair-partner-test@googlegroups.com) avec vos comptes Google de test.
Pour capturer les messages d'Association express dans vos journaux de débogage, exécutez la commande suivante :
$ 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 recommande d'exécuter les commandes précédentes à chaque séquence de démarrage.
Extraire un journal de débogage
Exécutez $ adb bugreport pour générer un fichier ZIP contenant toutes les données. La génération du fichier ZIP peut prendre plusieurs minutes.
Selon la version d'Android, exécutez l'une des commandes suivantes pour obtenir btsnoop_hic.log :
- Pour Android 8.x et versions ultérieures :
shell $ adb pull data/misc/bluetooth/logs logs - Pour Android 7.x :
shell $ adb pull sdcard/btsnoop_hci.log