نصب چشمک در یونیتی

 آخرین نسخه یونیتی به همراه پلاگین اندریود را نصب کنید. برای دانلود وابستگی های لازم نیاز است که از نرم افزار های تغییر IP ایران استفاده نمایید. مطمئن شوید قبل از اضافه کردن چشمک به بازی خود، فایل apk شما بدون خطا در گوشی اجرا می شود. 

 

1. فایل های زیر دانلود کنید و از حالت فشرده خارج نمایید

 play-services-resolver

کتابخانه چشمک برای یونیتی 

 

2. فایل play-services-resolver-*.unitypackage را با راست کلیک بر پوشه Assets و مطابق عکس زیر، وارد پروژه خود نمایید. این کار را برای کتابخانه چشمک یعنی  cheshmal_lib_4.*.unitypackage تکرار کنید.  

 

با اطمینان از وصل بودن نرم افزارهای گذر از تحریم IP های ایران، بر روی پوشه Assets راست کلیک کرده و وابستگی های لازم را دانلود کنید. 

در این مرحله شما باید بتوانید در مسیر  Assets\Plugins\Android  کتابخانه های دانلود شده را مشاهده کنید. 

3. در مکانی که برنامه یونیتی را نصب کرده اید به مسیر

Unity\Editor\Data\PlaybackEngines\AndroidPlayer\Apk

 بروید و فایل AndroidManifest.xml  را پیدا کنید. قصد داریم که یک کپی از این فایل را، در برنامه خود داشته باشیم. برای همین به مسیر  Assets\Plugins\Android رفته و با راست کلیک کردن، فایل AndroidManifest را وارد پروژه خود کنید. بعد از ایمپورت کردن فایل منیفست، برای ویرایش بر روی آن دابل کلیک و تگ application را پیدا کنید. دو تغییر زیر را مطابق عکس به این فایل اضافه نمایید. (appKey اپلیکیشن خود را  از پنل چشمک دریافت کنید)

android:name="unity.cheshmak.wrapper.MyCheshmak"
<meta-data android:name="appKey" android:value="MY_APP_KEY_HERE"/>

 

* به یکسان بودن پکیج نیم در یونیتی و پنل چشمک دقت کنید:

 

تنظیمات چشمک با موفقیت انجام شد. اپلیکیشن  را بیلد گرفته و درون موبایل خود اجرا کنید. با رفرش کردن پنل چشمک دستگاه شما در لیست
نصب‌ها قرار گرفته و پس از گذشت ۱ دقیقه می‌توانید به اپلیکیشن خود پوش  ارسال کنید. در صورت تمایل می توانید با رفتن به این لینک  درآمد دلاری را در بازی های خود فعال نمایید.

پروژه نمونه

دانلود  پروژه نمونه

باز شدن برنامه با کلیک بر روی پوش نوتیفیکیشن

اگر می خواهید بازی شما بعد از کلیک کاربر بر روی پوش نوتیفیکیشن اجرا شود، مراحل زیر را دنبال کنید:

 فایل AndroidManifest.xml که در مرحله نصب چشمک کپی کرده اید، باز کنید و خط

<meta-data android:name="cheshmakPush" android:value="openActivityOnPush"/>

را بین تگ activity اضافه کنید.

ارسال داده با فرمت JSON

در چشمک این قابلیت وجود دارد تا پس از این که پوش نوتیفیکیشن را ارسال کردید هیچ نوتیفیکیشنی به کاربر نمایش داده نشود، بلکه تنها  داده با فرمت JSON به آن ارسال شود. ( برای این کار در پنل چشمک، پوش پیشرفته و  ” عدم نمایش پوش و تنها ارسال اطلاعات به برنامه ”  را انتخاب کنید)

ممکن است از خودتان بپرسید انجام چنین کاری چه فایده ای دارد؟ این کار به شما کمک می کند تا تغییراتی را در اپلیکیشن خود اعمال کنید بدون این که کاربرتان متوجه این تغییرات باشد.

فایل AndroidManifest.xml که در مرحله نصب چشمک کپی کرده اید، باز کنید و کد زیر را در تگ application اضافه کنید

<service android:name="unity.cheshmak.wrapper.CheshmakService">
     <meta-data android:name="cheshmakPush" android:value="startServiceOnPush" />
</service>

 

بعد از ارسال پوش، تابع onJsonReceived در فایل Cheshmak.cs  با مقدار ارسالی شما فرخوانی می شود.

ارسال پوش به یک دستگاه خاص (cheshmak ID)

رای هر کاربر در هر اپلیکیشنی که SDK چشمک در آن نصب شده باشد یک شناسه منحصر به فرد به نام Cheshmak ID ساخته می‌شود. این شناسه در برنامه اندروید شما قابل دسترسی می‌باشد. شما قادر خواهید بود چشمک آی دی را به سرور خودتان ارسال کنید.

در سرور های خودتان می‌توانید با استفاده از Rest API چشمک و داشتن Cheshmak ID به کاربر مشخصی از اپلیکیشن خود پوش نوتیفیکیشن ارسال کنید. 

برای دریافت cheshmak ID، ابتدا فایل AndroidManifest.xml که در مرحله نصب چشمک کپی کرده اید، باز کنید و کد زیر را در تگ application اضافه کنید.

<meta-data android:name="cheshmakID" android:value="true"/>

مدتی بعد از نصب اپ شما، شناسه چشمک آی.دی در به onCheshmakIdReceived در فایل Cheshmak.cs ارسال می شود.

تگ کردن کاربران

یکی از نیاز های مهم برنامه نویسان دسته بندی کاربران بر اساس ویژگی های مختلف از جمله سطح دسترسی کاربر جنسیت سن علایق و … می باشد .جهت رفع این نیاز برنامه نویس نیاز دارد که به هر کاربر مشخصه هایی را تخصیص دهد که در چشمک به آنها تگ گفته می شود .

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

چگونه کاربران را تگ کنیم؟

جهت تگ کردن کاربران شما می‌توانید با استفاده از تابع sendTag به صورت تکی و تابع sendTags به صورت لیستی از تگ ها برای نشان دادن در پنل استفاده کنید روش استفاده از هرکدام مانند مثال زیر است.

CheshmakLib.sendTag("VIP");

در صورتی که بخواهید همزمان چند تگ را به یک کاربر اختصاص دهید:

CheshmakLib.sendTags(new string[3] {"VIP", "Admin", "NEW"});

چگونه تگ ها را حذف کنیم ؟

تگ های تخصیص یافته به کاربران را میتوان به دو روش تکی و چند تایی حذف کرد: روش تکی.

CheshmakLib.deleteTag("VIP");

روش چند تایی:

CheshmakLib.deleteTags(new string[3] {"VIP", "Admin", "NEW"});

پاک کردن همه تگ ها:

CheshmakLib.deleteAllTags();