Partage et exécution d'actions sur des applications distantes à l'aide du tethering d'app

De RAD Studio
Aller à : navigation, rechercher

Remonter à Utilisation du tethering d'app


L'implémentation du tethering d'app de la RTL fournit la prise en charge des actions. Vous pouvez utiliser le tethering d'app pour :

Pour pouvoir partager des actions à l'aide du tethering d'app, ajoutez le tethering d'app à votre application et préparez votre application pour la découverte, l'appairage et la connexion à d'autres applications.

Création d'actions

Avant de pouvoir partager des actions à l'aide du tethering d'app ou exécuter des actions distantes en utilisant des actions locales, vous devez comprendre ce que représente ces actions et comment les définir :

Partage d'actions

Pour partager une action existante :

  1. Sélectionnez votre composant TTetheringAppProfile sur le Concepteur de fiches et double-cliquez sur sa propriété Actions dans l'inspecteur d'objets.
  2. Sur l'éditeur de liste d'actions qui s'ouvre, cliquez sur Nouveau pour ajouter un nouveau TLocalAction à la liste. Un TLocalAction fournit des informations de partage à propos d'une action réelle.
  3. Avec votre nouveau TLocalAction sélectionné sur l'éditeur de liste d'actions, ouvrez la zone de liste déroulante de la propriété Action sur l'inspecteur d'objets et sélectionnez l'action existante que vous voulez associer à cette instance de TLocalAction.

Votre action est désormais partagée à l'aide du tethering d'app. Les applications connectées peuvent exécuter cette action à distance sur votre application.

Exécution d'actions distantes

Lorsque votre application est connectée à une application qui partage des actions, vous pouvez exécuter ces actions partagées à distance sur l'application cible.

Si vous utilisez des groupes pour se connecter à d'autres applications, vous pouvez associer les actions distantes aux actions locales à la conception. L'exécution de ces actions locales déclenche l'exécution des actions distantes associées.

Que vous utilisiez ou non des groupes pour se connecter à d'autres applications, vous pouvez exécuter des actions distantes synchrones ou asynchrones à l'exécution en utilisant leur nom d'action.

Exécution d'actions distantes en utilisant des actions locales sur les applications connectées par le biais de groupes

Pour associer une action locale à une action distante à la conception :

  1. Créez une action de même nom que l'action distante que vous voulez déclencher. Voir Création d'actions.
  2. Suivez les étapes ci-dessus pour partager cette action à l'aide du tethering d'app.
  3. Avec votre nouveau TLocalAction sélectionné sur l'éditeur de liste d'actions, définissez sa propriété Kind dans l'inspecteur d'objets sur Mirror.

Lorsque vous définissez la propriété Kind de votre TLocalAction sur Mirror, votre TLocalAction ne partage pas l'action que vous avez définie dans sa propriété Action. A la place, chaque fois que vous exécutez l'action associée dans votre application, TLocalAction déclenche une action distante de même nom que celui spécifié dans votre TLocalAction.

Exécution d'actions distantes avec RunRemoteAction

Votre composant TTetheringAppProfile fournit une méthode, RunRemoteAction, que vous pouvez utiliser pour exécuter des actions distantes.

Vous pouvez spécifier une action distante à exécuter avec l'un des jeux de paramètres suivants :

  • Fournissez le profil d'application distante qui contient l'action distante sous la forme d'une instance de TTetheringProfileInfo et le nom de l'action distante.
La propriété RemoteProfiles de votre composant TTetheringManager fournit une liste de profils d'applications distantes qui sont connectés à votre profil.
Votre composant TTetheringAppProfile fournit une méthode, GetRemoteProfileActions, qui renvoie une liste d'actions distantes partagées par un profil d'application distante donné, spécifié en tant qu'instance de TTetheringProfileInfo.

Exécution d'actions distantes avec RunRemoteActionAsync

Votre composant TTetheringAppProfile fournit une méthode, RunRemoteActionAsync, que vous pouvez utiliser pour exécuter des actions distantes asynchrones. En exécutant des actions distantes asynchrones, l'appelant n'est pas bloqué pendant l'exécution de l'action distante.

Vous pouvez spécifier une action distante à exécuter avec l'un des jeux de paramètres suivants :

  • Fournissez le profil d'application distante qui contient l'action distante sous la forme d'une instance de TTetheringProfileInfo et le nom de l'action distante.
La propriété RemoteProfiles de votre composant TTetheringManager fournit une liste de profils d'applications distantes qui sont connectés à votre profil.
Votre composant TTetheringAppProfile fournit une méthode, GetRemoteProfileActions, qui renvoie une liste d'actions distantes partagées par un profil d'application distante donné, spécifié en tant qu'instance de TTetheringProfileInfo.

Voir aussi

Récupérée de « https://docwiki.embarcadero.com/RADStudio/Athens/f/index.php?title=Partage_et_exécution_d%27actions_sur_des_applications_distantes_à_l%27aide_du_tethering_d%27app&oldid=203398 »