Clustraly
Assistant vocal

Détection de capacité du navigateur et masquage des points d'entrée : la voix s'efface là où elle ne peut pas fonctionner

Détection de capacité du navigateur et masquage des points d'entrée une fonctionnalité du module Assistant vocal de Clustraly. La détection de capacité du navigateur repère les navigateurs sans entrée vocale et masque les points d'entrée de l'assistant, laissant l'admin intact au clavier.

Sur les navigateurs sans entrée vocale, Clustraly efface tous les points d'entrée de l'assistant pas de bouton mort, pas de menu inerte tout en gardant l'administration entièrement pilotable au clavier.

Détection de capacité

La voix ne s'affiche que là où elle fonctionne vraiment

Sur un navigateur qui ne sait pas transformer la parole en texte, l'assistant vocal se comporte comme s'il n'existait pas. Vos équipes ne voient ni bouton micro grisé, ni menu qui ne répond pas juste un admin normal.

Serveur et client se coordonnent avant le rendu pour décider si les points d'entrée vocaux méritent d'être affichés, sans jamais toucher au reste de l'administration.

  • Détecte Firefox, Brave et les contextes non sécurisés (HTTP)
  • Aucun bouton vocal mort ni menu inerte
  • Le reste de l'admin reste identique et intact
Voir comment la capacité est détectée
Verdict serveur + client

Un cookie de verdict qui dit au serveur quoi rendre

Le client écrit un cookie de verdict (clustraly_voice_cap, 1 ou 0) à chaque chargement. Au rendu suivant, le serveur lui fait confiance pour n'émettre les points d'entrée vocaux que sur les navigateurs capables.

Tant que le cookie n'est pas encore posé, browserSupported() infère depuis le contexte (HTTP contre HTTPS) et l'agent Firefox, pour trancher dès la première visite.

  • Cookie clustraly_voice_cap 1/0, valable 6 mois, SameSite=Lax
  • Attribut Secure ajouté automatiquement en HTTPS
  • browserSupported() infère avant même le premier cookie
Trois cas couverts

Firefox, Brave et HTTP repérés à la source

La détection client distingue Firefox (pas de SpeechRecognition), Brave (qui livre l'API mais en retire le moteur, révélé par navigator.brave.isBrave en asynchrone) et les contextes non sécurisés. Chaque cas conduit au même verdict propre.

  • Firefox : absence de SpeechRecognition
  • Brave : API présente mais moteur retiré (test asynchrone)
  • Contexte non sécurisé (HTTP) écarté
Index élagué

Rien de vocal ne traîne dans votre recherche interne

À la première visite, avant même le cookie, pruneVoiceMenu() retire les tuiles du lanceur vocal, les lignes d'aide et les liens de sidebar, ainsi que les ids voice-assistant et voice-diagnostics de l'index de recherche local.

Résultat : sur un navigateur incapable, une recherche interne ne renvoie jamais une fonctionnalité vocale que l'utilisateur ne pourrait pas utiliser.

  • Retire tuiles du lanceur, lignes d'aide et liens de sidebar
  • Purge les ids voice-assistant et voice-diagnostics de l'index
  • S'applique dès la première visite, avant le cookie de verdict
Garde-fou fail-open

Au moindre accroc, l'admin reste pleinement utilisable

La règle est fail-open : si la détection hésite ou échoue, le module reste visible et l'administration reste entièrement pilotable au clavier. Un doute technique ne bloque jamais votre travail.

Le masquage n'est qu'un retrait discret des points d'entrée vocaux : il ne dégrade jamais le reste de l'interface.

  • Tout accroc laisse l'admin 100 % fonctionnel au clavier
  • Le masquage ne dégrade jamais le reste de l'interface
  • Comportement prévisible : la voix s'ajoute, ne retire rien
Comprendre le principe fail-open
Pourquoi ça compte

Se comporter comme s'il n'existait pas

L'objectif est simple : sur un navigateur qui ne peut pas écouter, l'assistant vocal disparaît proprement pas d'erreur, pas de contrôle cassé, pas de piste morte dans la recherche. Vous décidez d'activer la voix ; le navigateur détermine s'il peut la rendre ; l'admin reste intact dans tous les cas.

FAQ

Questions fréquentes

Que voient les utilisateurs sur Firefox ou Brave ?
Un admin normal, sans aucun point d'entrée vocal. Firefox n'expose pas SpeechRecognition et Brave retire le moteur derrière l'API ; dans les deux cas, boutons, menus et liens vocaux ne sont tout simplement pas rendus.
Pourquoi la voix n'apparaît-elle pas en HTTP ?
La reconnaissance vocale exige un contexte sécurisé. La détection écarte les pages non sécurisées, et le cookie de verdict n'active les points d'entrée qu'en HTTPS, avec l'attribut Secure ajouté au cookie.
À quoi sert le cookie clustraly_voice_cap ?
Il transmet au serveur le verdict de capacité mesuré côté navigateur (1 ou 0). Le serveur s'y fie pour n'émettre les points d'entrée vocaux que là où ils fonctionnent. Il vit six mois, en SameSite=Lax.
Que se passe-t-il si la détection échoue ?
Le module suit une règle fail-open : en cas de doute, il reste visible et l'administration reste entièrement utilisable au clavier. Aucun accroc de détection ne peut couper l'accès à l'admin.
Prêt à commencer ?

La voix quand c'est possible, jamais dans le chemin quand ça ne l'est pas

La détection de capacité du navigateur et le masquage des points d'entrée gardent votre administration propre partout : l'assistant vocal se révèle là où il fonctionne, s'efface ailleurs, et laisse toujours le clavier maître. Vous activez la voix, le navigateur confirme qu'il peut la rendre, Clustraly s'occupe du reste.