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

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

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

۰. پیش نیاز ها

  • Apple Developer Account
  • حساب کاربری کاوه نگار
  • NodeJS & NPM
  • حداقل ۲ دستگاه با سیستم عامل iOS
  • Carthage

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

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

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

۲. ایجاد اپلیکیشن در پنل Apple Developer

برای ایجاد اپلیکیشن طبق ویدئو زیر عمل کنید.

نکته

Bundle Id و Application Name مورد نظر خود را وارد نمائید.

۳. ایجاد Certificate برای ارسال Push Notification

کیت توسعه سرویس تماس اینترنتی کاوه نگار برای دریافت تماس از سرویس PushKit استفاده می کند. اگر می خواهید کاربران شما تماس های دریافتی را بگیرند باید برای اپلیکیشن خود VOIP Certificate ایجاد نمائید.

نکته

برای مشاهده تفاوت PushKit و UserNotifications صفحه iOS SDK > دریافت تماس را مطالعه نمائید.

می توانید به صورت جداگانه برای PushNotification های تماس خود Certificate مختص به VoIP بسازید (VoIP Services Certificate) و یا از (Apple Push Notification service SSL (Sandbox & Production استفاده کنید که امکان ارسال هر نوع PushNotification را به شما می دهد.

بعد از ایجاد Certificate شما یک فایل با پسوند cer خواهید داشت.

در مرحله بعد فایل cer را باید به فایل p12 تبدیل کنیم که برای ارسال Push Notification به آن نیاز خواهیم داشت :

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

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

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

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

۱. نمونه کد Back-End را به صورت زیر دریافت کنید :

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

۲. فایل P12 Certificate دریافت شده در مرحله قبل را به شاخه اصلی پروژه منتقل کنید.

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

  • backend:kavenegar-api-token : اپلیکیشن توکن کاوه نگار که بعد از ساخت اپلیکیشن دریافت کرده اید
  • backend:apn-certificate-file : مسیر فایل P12 Certificate دریافت شده در مرحله قبل
  • backend:apn-certificate-password : پسورد فایل P12 Certificate
  • backend:apn-topic : آدرس BundleId پروژه

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

npm install && npm start -s \
 --backend:kavenegar-api-token=KAVENEGAR_CALL_TOKEN \
 --backend:apn-certificate-file=./YOUR_CERTIFICATE_FILE.cert \
 --backend:apn-certificate-password=YOUR_CERTIFICATE_PASSWORD \
 --backend:apn-topic=APP_BUNDLE_ID

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

Kavenegar Backend Sample is listening on port 3000
[http://192.168.1.188:3000]

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

۵. راه اندازی نمونه کد iOS

۱. نمونه اپلیکیشن iOS را به صورت زیر دریافت کنید :

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

۲. سپس پروژه را با XCode 9 به بالا باز کنید.

۳. دستور زیر را شاخه اصلی پروژه اجرا کنید :

carthage update --platform ios

۴. فایل AppDelegate.swift را باز کرده و Public آدرس سرور که در مرحله قبل دریافت کرده اید را در آن قرار دهید.

import UIKit
import KavenegarCall


var backendApiPath = "http://192.168.1.188:3000"

۵. به صفحه تنظیمات پروژه بروید و ‍‌Bundle Identifier پروژه را مطابق فایل Certificate خود تنظیم کنید.

۶. آزمایش

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

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

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

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




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