شروع کنید

این سند نحوه شروع توسعه با Nearby Messages API در Android را توضیح می‌دهد. Nearby Messages API بخشی از خدمات Google Play است.

مرحله ۱: دریافت خدمات Google Play

Nearby Messages API در دستگاه‌های Android با خدمات Google Play نسخه ۷.۸.۰ یا بالاتر دردسترس است. دستگاه‌های دارای Android نسخه ۲.۳ یا بالاتر که برنامه «فروشگاه Google Play» را دارند، به‌طور خودکار به‌روزرسانی‌های «خدمات Google Play» را دریافت می‌کنند. برای بررسی اینکه کدام نسخه از «خدمات Google Play» در دستگاهتان نصب شده است، به تنظیمات > برنامه‌ها > خدمات Google Play بروید.

مطمئن شوید که جدیدترین کتابخانه کارخواه را برای خدمات Google Play در میزبان توسعه خود دارید:

  1. مدیر کیت توسعه نرم‌افزار Android را باز کنید.
  2. در بخش Appearance & Behavior > System Settings > Android SDK > SDK Tools، مطمئن شوید بسته‌های زیر نصب شده باشند:

    • خدمات Google Play
    • مخزن Google

مرحله ۲: دریافت حساب Google

برای استفاده از Nearby Messages API، به حساب Google نیاز دارید. این کار برای این است که شما، به‌عنوان توسعه‌دهنده، بتوانید Nearby API را در مرحله بعدی فعال کنید (کاربران شما نیازی به داشتن حساب Google نخواهند داشت). اگر ازقبل حساب دارید، همه چیز آماده است. همچنین ممکن است برای اهداف آزمایشی به یک «حساب Google» جداگانه نیاز داشته باشید.

مرحله ۳: دریافت کلید میانای برنامه‌سازی کاربردی

برای فعال کردن Google Nearby Messages API برای Android و دریافت کلید API، این مراحل را دنبال کنید:

  1. به Google Developers Console بروید.
  2. پروژه‌ای را برای ثبت برنامه‌تان ایجاد یا انتخاب کنید.
  3. روی ادامه کلیک کنید تا میانای برنامه‌سازی کاربردی فعال شود.
  4. در صفحه اعتبارنامه‌ها، کلید Android جدیدی ایجاد کنید (و اعتبارنامه‌های API را تنظیم کنید).
    توجه: اگر ازقبل کلید Android دارید، می‌توانید از آن کلید استفاده کنید.
  5. در کادر گفتگوی حاصل، اثر انگشت SHA-1 و نام بسته برنامه‌تان را وارد کنید. برای مثال:
    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. کلید میانای برنامه‌سازی کاربردی Android جدیدتان در فهرست کلیدهای میانای برنامه‌سازی کاربردی پروژه‌تان نشان داده می‌شود. کلید میانای برنامه‌سازی کاربردی رشته‌ای از نویسه‌ها است، چیزی شبیه به این:
    AIzaSyBdVl-cTICSwYKrZ95SuvNw7dbMuDt1KG0

اثر انگشت SHA1 گواهینامه‌تان را دریافت کنید

برای ایجاد کلید میانای برنامه‌سازی کاربردی جدید برای برنامه Android، به اثر انگشت SHA1 گواهینامه‌ای که برای امضای APK استفاده می‌کنید نیاز دارید. پیام‌ها فقط می‌توانند بین برنامه‌هایی ردوبدل شوند که با کلیدهای میانای API از یک پروژه امضا شده باشند.

برای دریافت این اثر انگشت:

  1. مکان keystore خود را پیدا کنید.
  2. در پایانه، ابزار keytool را از «کیت توسعه جاوا» اجرا کنید. برای مثال، اگر از مخزن کلید `debug` استفاده می‌کنید:
  3. $ keytool -alias \
    androiddebugkey -keystore \
    ~/.android/debug.keystore -list -v
    

    توجه: برای ذخیره‌گاه کلید اشکال‌زدایی، گذرواژه android است. در Mac OS و Linux، مخزن کلید اشکال‌زدایی معمولاً در ~/.android/debug.keystore قرار دارد. در Windows، معمولاً در %USERPROFILE%\.android\debug.keystore قرار دارد.

  4. خروجی فرمان keytool حاوی اثر انگشت SHA1 برای گواهینامه است.

مرحله ۴: پیکربندی پروژه

Android Studio ایجاد پروژه برای Nearby Messages API را آسان می‌کند. مراحل شرح‌داده‌شده در ایجاد پروژه را دنبال کنید تا پروژه جدیدی ایجاد کنید. در Android Studio، فایل build.gradle را برای مدول خود باز کنید و کتابخانه کارخواه «خدمات Google Play» را به‌عنوان وابستگی اضافه کنید:

apply plugin: 'android'
...

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

سپس، مانیفست خود را با «کلید میانای برنامه‌سازی کاربردی» تولیدشده در مرحله قبل پیکربندی کنید:

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

مرحله ۵: انتشار و اشتراک

در برنامه‌تان، استفاده از Nearby Messages API را شروع کنید.

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

Nearby Messages API به رضایت کاربر نیاز دارد. وقتی برای اولین‌بار انتشار یا اشتراک فراخوانی می‌شود، Nearby کادر گفتگوی موافقت را نشان می‌دهد.