راهنمای نصب سریع Android

در این آموزش می خواهیم به صورت قدم به قدم نحوه راه اندازی تماس اینترنتی در پلتفرم اندروید را آموزش دهیم.

بعد از انجام مراحل زیر شما قادر خواهید بود که بین ۲ دستگاه اندرویدی تماس اینترنتی برقرار نمائید.

نکته

در صورت تمایل به اطلاعات بیشتر به مستندات REST API و Android SDK مراجعه کنید.

۰. پیش نیاز ها

  • اکانت Firebase
  • اکانت کاوه نگار
  • Node.js & NPM (نسخه ۸ به بعد)
  • ۲ دستگاه اندرویدی (‌ واقعی یا شبیه ساز )

۱. ایجاد برنامه در پنل کاوه نگار

برای شروع کار باید یک برنامه (Application) برای کار خود ایجاد کنید.

به صفحه تماس اینترنتی > ایجاد برنامه در پنل کاوه نگار مراجعه کنید. و بعد از ساخت برنامه ApiToken دریافت شده را برای مراحل بعد ذخیره کنید.

۲. ایجاد پروژه در Firebase

در سرویس تماس اینترنتی کاوه نگار، اطلاع رسانی تماس های دریافتی به مخاطب (Receptor) از طریق سرویس Push Notification انجام می شود. یعنی زمانی که Caller می خواهد با Receptor تماس بگیرد درخواست تماس به Receptor از طریق Push Notification ارسال می شود.

سرویس های مختلفی برای ارسال Push Notification به اندروید وجود دارند که ما در این آموزش از سرویس Firebase استفاده می کنیم.

نکته

در صورتی که شما از سرویس دیگری برای ارسال Push Notification استفاده می کنید می توانید این بخش را در آن سرویس انجام دهید.

برای راه اندازی به Firebase Console مراجعه کنید. و مراحل زیر را مطابق ویدئو انجام دهید :

  • یک پروژه ایجاد کنید.

  • سپس یک اپلیکیشن اندروید با Package Name زیر ایجاد کنید : io.kavenegar.call.android.sample

  • فایل google-services.json را ذخیره نمائید و با زدن دکمه Skip this step از بقیه مراحل بگذرید.

  • به صفحه Setting > Service accounts رفته و در تب Firebase Admin SDK بر روی دکمه Generate a new private key کلیک کرده و فایل دریافت شده را ذخیره نمائید.

نکته

بعد از انجام مراحل ویدئو به صورت صحیح ۲ فایل دریافت خواهید کرد :

  • فایل ‍‍google-services.json که در اپلیکیشن اندروید مورد استفاده قرار می گیرد.
  • فایل FireBase Admin Sdk که برای ارسال Push Notification در نمونه کد BackEnd مورد نیاز است.

۳. راه اندازی نمونه کد Back-End

برای پیاده سازی سرویس تماس اینترنتی باید بخشی از کارها در Back-End انجام شود :

  • ایجاد تماس از طریق REST API کاوه نگار
  • ارسال پوش نوتیفیکیشن
  • تشخیص هویت کاربران

برای راه اندازی نمونه کد Back-End مراحل زیر را انجام دهید.

۱. نمونه کد را از مسیر زیر دریافت کنید :

git clone https://github.com/kavenegar/call-backend-sample-node

۲. فایل Firebase Admin Sdk دریافت شده در مرحله قبل را به شاخه اصلی پروژه انتقال دهید.

۳. برای اجرای پروژه باید پارامترهای زیر را مقدار دهی کنید :

  • backend:kavenegar-api-token : شناسه اپلیکیشن ( Application Token ) کاوه نگار که بعد از ساخت اپلیکیشن دریافت کرده اید

  • backend:firebase-project-file : مسیر فایل Firebase Admin Sdk دریافت شده در مرحله قبل

برای راه اندازی دستور زیر را با مقادیر مناسب اجرا کنید :

npm install && npm start -s  \ 
--backend:kavenegar-api-token=eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJpbmZvQG1vaHNlbi53b3JrIiwicm9sZXMiOiJ1c2VyIiwidXNlcklkIjoxLCJhcHBsaWNhdGlvbklkIjoxLCJpYXQiOjE1MjU1MDExNzd9.N7B7kB3ATFKYcUgVkpybKM5dMmSUlIDiycUMHd2_sLY  \ 
--backend:firebase-project-file=./kavenegar-call-test-firebase-adminsdk-3c13i-5854914aaf.json

سپس خروجی زیر را دریافت می کنید :

Kavenegar Backend Sample Config :  {
    "kavenegarApiToken": "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJpbmZvQG1vaHNlbi53b3JrIiwicm9sZXMiOiJ1c2VyIiwidXNlcklkIjoxLCJhcHBsaWNhdGlvbklkIjoxLCJpYXQiOjE1MjU1MDExNzd9.N7B7kB3ATFKYcUgVkpybKM5dMmSUlIDiycUMHd2_sLY",
    "firebaseProjectFile": "./kavenegar-call-test-firebase-adminsdk-3c13i-5854914aaf.json"
}
Kavenegar Backend Sample is listening on port 3000
[http://192.168.1.188:3000] // Server Local IP Address

در صورت گرفتن پیام مشابه تنظیمات موفقیت آمیز بوده و مرحله بعد را انجام دهید.

نکته

در خروجی بالا ‌IP آدرس ‍‍192.168.1.188 عمومی می باشد و برای اتصال اپلیکیشن اندروید به Back-End باید از این IP استفاده شود.

۴. راه اندازی نمونه کد اندروید

نمونه کد اندروید را می توانید به صورت زیر دریافت نمائید :

git clone https://github.com/kavenegar/call-android-sample

بعد از دریافت پروژه آن را با Android Studio نسخه ۳ به بالا باز کنید. مراحل زیر را مطابق ویدئو انجام دهید :

  • فایل MyApplication.java را باز کرده و Public آدرس BackEnd که در مرحله قبل دریافت کرده اید را در آن قرار دهید.

  • فایل ‍‍google-services.json‍ که در مرحله ۲ دریافت کردید را به شاخه sample در پروژه انتقال دهید.

  • در نهایت اپلیکیشن را Build کرده و بر روی هر ۲ دستگاه اجرا کنید.

۵. آزمایش

بعد از انجام دادن تمامی مراحل بالا شما می توانید بین ۲ دستگاه اندرویدی تماس اینترنتی برقرار نمائید.

برای این کار اپلیکیشن اندروید را بر روی ۲ دستگاه یا شبیه ساز نصب نمائید.

برای مثال در دستگاه اول با نام کاربری mohsen و در دستگاه دوم با نام کاربری mohammad لاگین کنید.

در صورتی که هر دو با موفقیت لاگین شدند در یکی از دستگاه ها نام کاربری طرف مقابل را وارد کرده و دکمه تماس را بزنید.

Android App Preview


مستندات Android SDK ← مستندات REST API ←