دریافت SDK

دریافت و نصب SDKهای کلاینت و سرور «اینجام» روی پلتفرم‌های مختلف

دریافت و نصب

به‌طور کلی SDKهای «اینجام» به دو دسته سمت کلاینت و سمت سرور تقسیم می‌شوند که هریک برای انجام کارهای متفاوتی باید مورد استفاده قرار گیرند و می‌توان این را گفت که داشتن SDK کلاینت درواقع پیش‌نیاز سرویس‌های SDK سرور به حساب می‌آید.


در ادامه به‌ترتیب روش‌های دریافت و نصب هریک از SDK‌های سمت کلاینت و سمت سرور را یکی پس از دیگری معرفی و موارد هریک را در بخش خود با جزییات کامل برای پلتفرم‌ها و پروژه‌های مختلف پوشش می‌دهیم.

کلاینت

وب

برای دریافت اینجام و استفاده از آن در وب می‌توانید SDK مخصوص را از گیت‌هاب Clone بگیرید یا از طریق NPM یا CDN آن را به پروژه خود اضافه کنید.


دریافت مستقیم از Github


یا:


        git clone git@github.com:injamio/web-sdk.git
    

استفاده سریع از CDN:


        <script async src="https://cdn.jsdelivr.net/npm/injam-sdk/injam-sdk.js"></script>
    

دریافت با استفاده از NPM:


        npm i injam-sdk
    

استفاده در مرورگر


        <script async src="./injam-sdk.js"></script>
    

وارد کردن به عنوان ماژول NodeJS


        var injamSdk = require('injam-sdk')
    

اندروید

اینجام برای اندروید در نسخه‌های مختلفی ارایه شده است که می‌توانید نسخه مورد نظر خود را از گیت‌هاب در تب Release دریافت کنید.


دریافت مستقیم از Github


برای وارد کردن به پروژه مسیر زیر را در اندروید استودیو دنبال کنید:


        File -> New -> New Module -> Import .jar/.aar Package
    

iOS

به زودی...


سرور

API

اگر SDK سمت سرور مناسب خود را پیدا نمی‌کنید یا به هر دلیلی می‌خواهید مستقیما API‌های اینجام را مورد استفاده قرار دهید، مستندات آن را همراه با جزییات کامل و مثال‌های کمکی مطالعه کنید:


مشاهده مستندات


به هرحال توصیه می‌شود که SDK هماهنگ با نرم‌افزار Backend خود را از موارد پایین پیدا و استفاده کنید تا با کمترین (تقریبا صفر) توسعه و کدنویسی و دغدغه‌های فنی به نتیجه مورد نظر برسید.

PHP

Laravel ~ نسخه ۵.۵ و بالاتر

نصب از طریق Composer:


        composer require injamio/injam-laravel-package
    

یا:

دریافت مستقیم از Github


فایل کانفیگ اینجام را ایجاد کنید:


        php artisan vendor:publish --provider="Injamio\InjamLaravelPackage\ServiceProvider" --tag="config"
    

پکیج اینجام را در کنترلر خود Use کنید:


        use Injamio\InjamLaravelPackage\InjamLaravelPackage;
    


وظایف SDK کلاینت:

۱. مدیریت برقراری اتصال به سرور اینجام

۲. احراز هویت خودکار

۳. محاسبه و به‌دست آوردن موقعیت مکانی فعلی دستگاه (با گرفتن تایید دسترسی از کاربر)

۴. ارسال و دریافت بی‌درنگ موقعیت مکانی

۵. ارسال و دریافت بی‌درنگ اطلاعات دلخواه


وظایف SDK سرور:

۱. احراز هویت

۲. تولید شناسه منحصربه‌فرد کاربر (Physical ID)

۳. افزودن ردیاب

۴. تعیین وضعیت ردیاب

۵. افزودن وب‌هوک

۶. حذف وب‌هوک