شروع کنید

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

مرحله 1: خدمات Google Play را دریافت کنید

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

اطمینان حاصل کنید که آخرین کتابخانه سرویس گیرنده خدمات Google Play را در میزبان توسعه خود دارید:

  1. Android SDK Manager را باز کنید.

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

    • خدمات گوگل پلی
    • مخزن گوگل

مرحله 2: یک حساب Google دریافت کنید

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

مرحله 3: یک کلید API دریافت کنید

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

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

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

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

برای بدست آوردن این اثر انگشت:

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

    توجه: برای فروشگاه کلید اشکال زدایی، رمز عبور android است. در سیستم عامل مک و لینوکس، فروشگاه کلید اشکال زدایی معمولاً در ~/.android/ debug.keystore قرار دارد. در ویندوز، معمولاً در %USERPROFILE%\ .android\ debug.keystore قرار دارد.

  3. خروجی دستور keytool حاوی اثر انگشت SHA1 برای گواهی است.

مرحله 4: پروژه خود را پیکربندی کنید

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

apply plugin: 'android'
...

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

سپس، مانیفست خود را با کلید API ایجاد شده در مرحله قبل پیکربندی کنید:

<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: انتشار و اشتراک

در برنامه خود، استفاده از 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 یک گفتگوی انتخاب را نشان می دهد.