Gestes

 

Pour bien débuter

Une fois votre marqueur initialisé, vous pouvez débuter le marquage des gestes effectués par vos utilisateurs.

Pour utiliser les classes et les méthodes du SDK, veillez à ajouter le namespace ATInternet dans votre Page.

Déclarez une variable de type Tracker dans votre Activity 

using System;
using System.Collections.Generic;
using Windows.Data.Json;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using ATInternet;

namespace App1
{
    public sealed partial class MainPage : Page
    {
        Tracker tracker;

        public MainPage()
        {
            this.InitializeComponent();
            tracker = SmartTag.Instance.defaultTracker;
        }
    }
}

 

Marquage

Pour marquer un geste, le tracker expose un objet Gestures proposant une méthode Add.

Par défaut, cette méthode ajoute un marquage de type « Touch ». Vous pouvez modifier le type d’évènement via la propriété Action de l’objet Gesture retourné par la méthode Add.

Les différentes actions sont les suivantes :

• Touch : Envoie un hit indiquant qu’un « touch » a eu lieu
• Navigate : Envoie un hit indiquant qu’un élément de navigation a été touché
• Download : Envoie un hit indiquant qu’un téléchargement a été provoqué
• Exit : Envoie un hit indiquant que l’utilisateur a changé de vue ou a quitté l’application
• Search : Envoie un hit indiquant que l’utilisateur a “cliqué” sur un élément d’un résultat de recherche

Pour envoyer les informations définies, vous devrez appeler manuellement la méthode SendNavigation, SendExit, SendDownload, SendTouch ou SendSearch de votre objet Gesture ou appeler la méthode Dispatch du Tracker.

Attention, l’appel aux méthodes SendNavigation, SendExit, SendDownload, SendTouch et SendSearch, modifie la propriété action de l’objet Gesture.

 

Exemples de marquage

1. Marquage d’un bouton de navigation :

   private void Button_clicked(object button, RoutedEventArgs e)
   {
        tracker.Gestures.Add("Go to product detail").SendNavigation();
        // ...
   }

2. Marquage d’un bouton de navigation avec chapitrage :

   private void Button_clicked(object button, RoutedEventArgs e)
   {
        tracker.Gestures.Add("Go to product detail", "Products", "Cart").SendNavigation();
        // ...
   }

3. Marquage d’un touch sur un bouton :

   private void Button_clicked(object button, RoutedEventArgs e)
   {
        Gesture gesture = tracker.Gestures.Add("Hello world !");
        gesture.Level2 = 1;
        gesture.SendTouch();
        // ...
   }

 

Classe Gesture

 

Propriétés

Nom	Type	Valeur par défaut	Description
Name	String	Chaîne vide	Obtient ou définit le nom du geste
Chapter1	String	null	Obtient ou définit le premier chapitre
Chapter2	String	null	Obtient ou définit le second chapitre
Chapter3	String	null	Obtient ou définit le troisième chapitre
Action	Enum	Action.Touch	Obtient ou définit le type d’action
Level2	Int	-1	Obtient ou définit l’identifiant du niveau 2

 

Méthodes

Nom	Type de retour	Description
SendTouch	void	Envoie un hit indiquant qu’un élément « cliquable » a été touché
SendNavigation	void	Envoie un hit indiquant qu’un élément de navigation a été touché
SendDownload	void	Envoie un hit indiquant qu’un téléchargement a été provoqué
SendExit	void	Envoie un hit indiquant que l’utilisateur a changé de vue ou a quitté l’application
SendSearch	void	Envoie un hit indiquant que l’utilisateur a « cliqué » sur un élément d’un résultat de recherche

Dernière mise à jour : 29/10/2015