Başlarken

Bu dokümanda, Nearby Messages API'yi kullanarak geliştirmeye nasıl başlayabileceğiniz açıklanmaktadır Android Yakındaki Mesajlar API'si, Google Play Hizmetleri.

1. adım: Google Play hizmetlerini edinin

Yakındaki Mesajlar API'si, şu özelliklere sahip Android cihazlarda kullanılabilir: Google Play Hizmetleri 7.8.0 veya sonraki sürümler. Android 2.3 veya sonraki bir sürümü çalıştıran ve Google Play Store uygulaması, Google Play hizmetlerinin güncellemelerini otomatik olarak alır. Kontrol etmek için cihazında Google Play Hizmetleri'nin hangi sürümünün yüklü olduğunu öğrenmek için şuraya git Ayarlar > Uygulamalar > Google Play Hizmetleri.

Cihazınızda Google Play Hizmetleri için en yeni istemci kitaplığına sahip olduğunuzdan emin olun geliştirme ana makinesi:

  1. Android SDK Yöneticisi'ni açın.

  2. Görünüm ve Davranış > Sistem Ayarları > Android SDK'sı > SDK Araçları, aşağıdaki paketlerin yüklendiğinden emin olun:

    • Google Play Hizmetleri
    • Google Kod Deposu

2. Adım: Bir Google hesabı edinin

Nearby Messages API'lerini kullanmak için Google Hesabınızın olması gerekir. Böylece siz geliştirici olarak bir sonraki adımda Nearby API'yi etkinleştirebilirsiniz adımı (kullanıcılarınızın Google Hesabı olması gerekmez). Halihazırda bir hesabınız varsa hazırsınız demektir. Ayrıca şunları da isteyebilirsiniz: test amacıyla ayrı bir Google Hesabı oluşturabilirsiniz.

3. Adım: API anahtarı alın

Android için Google Nearby Messages API'yi etkinleştirmek ve API anahtarı:

  1. gidin. Google Developers Console'da oturum açın.
  2. Uygulamanızın kaydedileceği bir proje oluşturun veya seçin.
  3. API'yi etkinleştirmek için Devam'ı tıklayın.
  4. Kimlik bilgileri sayfasında yeni bir Android anahtarı oluşturun (ve API'yi Kimlik bilgileri).
    . Not: Mevcut bir Android anahtarınız varsa bu anahtarı kullanabilirsiniz.
  5. Açılan iletişim kutusunda uygulamanızın SHA-1 parmak izini girin ve paket adı. Örnek: 
    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. Yeni Android API anahtarınız, projenizin API anahtarları listesinde görünür. API anahtarı, aşağıdaki gibi bir karakter dizesidir: 
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0
    .

Sertifikanızın SHA1 parmak izini alın

Android uygulamanız için yeni bir API anahtarı oluşturmak istiyorsanız SHA1 parmak izine ihtiyacınız vardır APK'nızı imzalamak için kullandığınız sertifikanın gerçek kimliği. Mesajlar yalnızca karşılıklı olarak gönderilebilir aynı projedeki API anahtarlarıyla imzalanan uygulamalar arasında geçiş yapın.

Bu parmak izini almak için:

  1. Anahtar deponuzun konumunu bulun.
  2. Bir terminalde, JDK'dan keytool yardımcı programını çalıştırın. Örneğin, `debug` anahtar deposunu kullanıyorsanız:
    3. $ keytool -alias \
androiddebugkey -keystore \
~/.android/debug.keystore -list -v

    Not: Hata ayıklama anahtar deposunun şifresi android. Mac OS ve Linux'ta, hata ayıklama anahtar deposu genellikle ~/.android/debug.keystore adresinde bulunuyor. Windows'da bulunduğu yer genellikle %USERPROFILE%\.android\debug.keystore.

  3. keytool komutunun çıktısı SHA1'i içerir izin almanız gerekir.
ziyaret edin.

4. Adım: Projenizi yapılandırın

Android Studio, Nearby Messages API için proje oluşturmak çok kolay. Açıklanan adımları uygulayın Proje Oluşturma yeni bir proje oluşturmaktır. Android Studio'da build.gradle dosyasını açın: modülünüz ve Google Play hizmetleri istemci kitaplığını bağımlılık olarak ekleyin:

apply plugin: 'android'
...

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

Ardından, manifest dosyanızı önceki adımda oluşturulan API anahtarıyla yapılandırın:

<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>

5. Adım: Yayınlama ve abone olma

Uygulamanızda Nearby Messages API'yi kullanmaya başlayın.

@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();
}

Yakındaki Mesajlar API'si için kullanıcı izni gerekir. Yayınlama veya abone olma çağrılırsa, Etrafımda özelliği bir etkinleştirme iletişim kutusu gösterir.