| Sélectionner la plate-forme : | iOS+ Android Web Flutter Unity C++ |
La configuration à distance en temps réel Remote Config vous permet de recevoir des clés et des valeurs de paramètres mises à jour dès que elles sont publiées sur le serveur. Vous pouvez ainsi mettre à jour rapidement n'importe quel type d' attribut d'application contrôlé à l'aide d'une valeur de paramètre Remote Config. Grâce aux mises à jour Remote Config en temps réel, vous pouvez :
- réduire les risques en déployant progressivement des fonctionnalités auprès des utilisateurs ciblés et en effectuant une restauration d'urgence si nécessaire ;
- accroître l'engagement des utilisateurs en personnalisant rapidement leurs expériences lorsqu'ils utilisent l'application. Par exemple, vous pouvez mettre à jour des bannières et proposer des incitations aux utilisateurs qui correspondent à des propriétés utilisateur Google Analytics spécifiques, ou ajuster dynamiquement la difficulté du jeu pour des groupes de joueurs ;
- réduire les dépendances de compilation et accroître la productivité des développeurs : utilisez Remote Config paramètres comme des flags de fonctionnalités pour exposer des fonctionnalités à vos équipes de développement et de test, tout en les masquant aux utilisateurs en production.
Pour découvrir d'autres façons d'utiliser Remote Config, consultez Que pouvez-vous faire avec Remote Config ?
Dans ce guide, vous allez :
- en savoir plus sur la relation client-serveur qui prend en charge les mises à jour en temps réel ;
- comprendre le fonctionnement de la fonctionnalité en temps réel dans le SDK ;
- découvrir comment utiliser les mises à jour en temps réel pour maintenir la configuration de votre application à jour.
Connexion client-serveur en temps réel
Lorsque vous implémentez la configuration à distance en temps réel Remote Config dans votre application, vous créez un écouteur en temps réel qui ouvre une connexion HTTP au Remote Config backend. La requête inclut la version de configuration mise en cache sur l'appareil. Le serveur Remote Config en temps réel utilise un message d'invalidation pour signaler à l'application quand une version plus récente d'une configuration côté serveur doit être récupérée.
Si le serveur dispose d'une version plus récente, il envoie immédiatement le signal d'invalidation.
S'il n'en dispose pas, il maintient la connexion ouverte et attend qu'une version soit publiée sur le serveur. Lorsque le SDK client reçoit un signal d'invalidation, il le récupère automatiquement, puis appelle le rappel de l'écouteur enregistré lorsque vous avez ouvert la connexion de l'écouteur. Cette récupération est semblable à l'appel de récupération que vous pouvez effectuer avec le SDK, mais elle contourne toute mise en cache ou tout paramètre minimumFetchInterval. La connexion client-serveur est maintenue lorsque l'application est au premier plan.
Étant donné que la connexion client-serveur est établie via HTTP, elle ne nécessite aucune dépendance vis-à-vis d'autres bibliothèques.
Écouter les mises à jour
Les mises à jour en temps réel complètent Remote Config fetch appels. Nous vous recommandons
d'appeler la récupération au démarrage de votre application (ou à un moment donné de son cycle de vie) et
d'écouter les mises à jour Remote Config en temps réel pendant la session utilisateur pour
vous assurer de disposer des dernières valeurs dès qu'elles sont publiées sur le
serveur.
Pour écouter les mises à jour, appelez
onConfigUpdated,
en implémentant un rappel qui est appelé chaque fois qu'une mise à jour Remote Config est
disponible dans l'application. En arrière-plan, cet appel commence à écouter les mises à jour
du serveur Remote Config. Pour en savoir plus sur la relation client-serveur, consultez la section précédente.
Le rappel est souvent un bon endroit pour utiliser activate afin de mettre les paramètres de configuration mis à jour à la disposition de votre application. Consultez Firebase Remote Config Loading
Strategies pour
découvrir d'autres stratégies permettant d'activer les valeurs de paramètres lorsque vous utilisez la configuration à distance en temps réel
Remote Config.
Activer sélectivement les valeurs de paramètres
Lorsque vous appelez
onConfigUpdated,
vous pouvez attendre la modification et l'activer.
RemoteConfigUpdate
est appelé lorsqu'une nouvelle version du modèle a été récupérée automatiquement et lorsque cette nouvelle version a modifié les valeurs de paramètres actifs dans l'application. Il renvoie configUpdate contient updatedKeys, qui est l'ensemble des clés de paramètres modifiées qui ont initié la mise à jour en temps réel et inclut les éléments suivants :
- Clés de paramètres ajoutées ou supprimées
- Clés de paramètres dont les valeurs ont changé
- Clés de paramètres dont les métadonnées ont changé (par exemple, Remote Config informations de personnalisation)
- Clés de paramètres dont la source de valeur a changé (par exemple, une valeur par défaut dans l'application qui passe à une valeur côté serveur)
Si vous utilisez un écouteur en temps réel dans une vue particulière de votre application, vous pouvez vérifier si les paramètres pertinents pour cette vue ont changé avant de les activer.
Parfois, une récupération (initiée lorsque vous appelez la méthode fetch ou par
la configuration à distance Remote Config) n'entraîne pas de mise à jour pour le client. Dans ce cas, la méthode ou la finalisation RemoteConfigUpdate ne seront pas appelées.
Ajouter et supprimer des écouteurs
onConfigUpdated
est le point d'entrée principal de la configuration à distance en temps réel Remote Config. Le premier appel de cet écouteur dans le cycle de vie de votre application ouvre la connexion au backend.
Les appels suivants réutilisent la même connexion, en multiplexant le message d'invalidation
décrit dans la connexion client-serveur en temps réel.
Pour fermer l'écouteur actif, vous pouvez annuler l'abonnement. S'il s'agit du seul écouteur enregistré, cela ferme la connexion en temps réel au serveur. Consultez l'
exemple Remote Config
Flutterfire
pour obtenir un exemple d'implémentation.
Pour arrêter l'écoute, stockez la référence à l'enregistrement de l'écouteur. Appelez remove pour arrêter l'écoute lors de cet enregistrement. S'il s'agit du seul écouteur enregistré, l'appel de remove ferme la connexion en temps réel au serveur.
Bien que vous puissiez arrêter manuellement l'écoute des mises à jour, cela n'est souvent pas nécessaire. La configuration à distance en temps réel Remote Config arrête automatiquement l'écoute des mises à jour lorsque l'application passe en arrière-plan et redémarre lorsqu'elle est au premier plan.
Étapes suivantes
Consultez Premiers pas avec Firebase Remote Config pour configurer Remote Config et commencer à écouter les mises à jour en temps réel.