‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

شروع کنید

این سند نحوه شروع توسعه با «میانای برنامه‌سازی کاربردی پیام‌های اطراف» در Android را توضیح می‌دهد. «میانای برنامه‌سازی کاربردی پیام‌های اطراف» بخشی از خدمات Google Play است.

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

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

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

مدیر کیت توسعه نرم‌افزار Android را باز کنید.
در بخش ظاهر و رفتار > تنظیمات سیستم > کیت توسعه نرم‌افزار Android > ابزارهای کیت توسعه نرم‌افزار، مطمئن شوید که بسته‌های زیر نصب شده باشند:
- خدمات Google Play
- مخزن Google

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

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

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

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

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

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

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

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

مکان keystore را پیدا کنید.
در پایانه، ابزار keytool را از JDK اجرا کنید. برای مثال، اگر از مخزن کلید `debug` استفاده می‌کنید:

$ keytool -alias \
androiddebugkey -keystore \
~/.android/debug.keystore -list -v

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

برونداد دستور 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>

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

در برنامه‌تان، شروع به استفاده از «میانای برنامه‌سازی کاربردی پیام‌های اطراف» کنید.

@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 کادر گفتگوی موافقت را نشان می‌دهد.