Commencer

Ce document explique comment commencer à développer avec l'API Nearby Messages sur Android L'API Nearby Messages fait partie de Services Google Play :

Étape 1: Accédez aux services Google Play

L'API Nearby Messages est disponible sur les appareils Android avec Services Google Play 7.8.0 ou version ultérieure. Les appareils fonctionnant sous Android 2.3 ou version ultérieure et dotés de l'application l'application Play Store reçoivent automatiquement les mises à jour des services Google Play. Pour vérifier la version des services Google Play installée sur votre appareil, accédez à Paramètres > Applications > services Google Play.

Assurez-vous de disposer de la dernière bibliothèque cliente pour les services Google Play sur votre hôte de développement:

  1. Ouvrez Android SDK Manager.

  2. Sous Apparence et Comportement > Paramètres système > SDK Android > SDK Tools, assurez-vous que les packages suivants sont installés:

    • Services Google Play
    • Dépôt Google

Étape 2: Obtenez un compte Google

Pour utiliser les API Nearby Messages, vous devez disposer d'un compte Google. Ainsi, vous, en tant que développeur, pouvez activer l'API Nearby lors de la prochaine (vos utilisateurs n'ont pas besoin d'avoir un compte Google). Si vous avez déjà un compte, vous êtes prêt. Vous voudrez peut-être aussi un compte Google distinct à des fins de test.

Étape 3 : Obtenez une clé API

Suivez ces étapes pour activer l'API Google Nearby Messages pour Android et obtenir une clé API:

  1. Accédez à la Google Play Console
  2. Créez ou sélectionnez un projet dans lequel enregistrer votre application.
  3. Cliquez sur Continuer pour activer l'API.
  4. Sur la page Identifiants, créez une clé Android (et définissez l'API identifiants).
    Remarque: Si vous disposez déjà d'une clé Android, vous pouvez l'utiliser.
  5. Dans la boîte de dialogue qui s'affiche, saisissez l'empreinte SHA-1 de votre application. et le nom du package. Par exemple: 
    BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
    com.example.android.nearbyexample
  6. Votre nouvelle clé API Android s'affiche dans la liste des clés API de votre projet. Une clé API est une chaîne de caractères semblable à celle-ci: 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

Obtenir l'empreinte SHA1 de votre certificat

Afin de créer une clé API pour votre application Android, vous avez besoin de l'empreinte SHA1. du certificat que vous utilisez pour signer votre APK. Les messages ne peuvent être échangés entre des applications signées avec des clés API du même projet.

Pour obtenir cette empreinte, procédez comme suit:

  1. Recherchez l'emplacement de votre keystore.
  2. Dans un terminal, exécutez l'utilitaire keytool à partir du JDK. Pour par exemple, si vous utilisez le keystore `debug`:
    3. $ keytool -alias \
androiddebugkey -keystore \
~/.android/debug.keystore -list -v

    Remarque:Pour le keystore de débogage, le mot de passe est android Sous Mac OS et Linux, le keystore de débogage est généralement situé à l'adresse ~/.android/debug.keystore. Sous Windows, il est généralement situé à %USERPROFILE%\.android\debug.keystore.

  3. Le résultat de la commande keytool contient l'algorithme SHA1 une empreinte numérique pour le certificat.

Étape 4: Configurez votre projet

Android Studio vous permet créer facilement un projet pour l'API Nearby Messages. Suivez les étapes décrites de la section Créer un projet pour créer un projet. Dans Android Studio, ouvrez le fichier build.gradle pour votre module et ajoutez la bibliothèque cliente des services Google Play en tant que dépendance:

apply plugin: 'android'
...

dependencies {
    compile 'com.google.android.gms:play-services-nearby:19.3.0'
}

Configurez ensuite votre fichier manifeste avec la clé API générée à l'étape précédente:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.google.sample.app" >
    <application ...>
        <meta-data
            android:name="com.google.android.nearby.messages.API_KEY"
            android:value="API_KEY" />
        <activity>
        ...
        </activity>
    </application>
</manifest>

Étape 5: Publier et vous abonner

Dans votre application, commencez à utiliser l'API Nearby Messages.

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    ...
    mMessageListener = new MessageListener() {
        @Override
        public void onFound(Message message) {
            Log.d(TAG, "Found message: " + new String(message.getContent()));
        }

        @Override
        public void onLost(Message message) {
            Log.d(TAG, "Lost sight of message: " + new String(message.getContent()));
        }
    }

    mMessage = new Message("Hello World".getBytes());
}

@Override
public void onStart() {
    super.onStart();
    ...
    Nearby.getMessagesClient(this).publish(mMessage);
    Nearby.getMessagesClient(this).subscribe(mMessageListener);
}

@Override
public void onStop() {
    Nearby.getMessagesClient(this).unpublish(mMessage);
    Nearby.getMessagesClient(this).unsubscribe(mMessageListener);
    ...
    super.onStop();
}

L'API Nearby Messages nécessite le consentement de l'utilisateur. Lors de la publication ou de l'abonnement est appelé en premier, Nearby affiche une boîte de dialogue d'activation.