بداية سريعة لـ Unity SDK

ابدأ باستخدام Pushwoosh Unity SDK مع هذا المثال السريع والبسيط

المتطلبات الأساسية

لدمج Pushwoosh Unity SDK في تطبيقك، ستحتاج إلى ما يلي:

المتطلبات

• حساب Pushwoosh.
• مشروع Pushwoosh تم إعداده في حسابك.
• لتكامل iOS:
  • منصة iOS مهيأة لإرسال إشعارات الدفع. نوصي باستخدام إعداد المصادقة المستندة إلى الرمز المميز (Token-Based Authentication) كأبسط طريقة.
  • أثناء الإعداد، قم بتعيين Gateway إلى Sandbox لإرسال الإشعارات إلى جهاز محاكاة.
• لتكامل Android:
  • منصة Android مهيأة
  • project number (المعروف أيضًا باسم Sender ID)، وملف google-services.json، وpackage name من مشروع Firebase الخاص بك.
  • مشروع Firebase متصل بتطبيق Android الخاص بك. اتبع دليل إعداد Firebase إذا لزم الأمر.
• Pushwoosh Application Code الخاص بك و Pushwoosh Device API Token من لوحة تحكم Pushwoosh لتطبيقك.

تنزيل المشروع التجريبي

انسخ مستودع المشروع التجريبي:

git clone git@github.com:Pushwoosh/pushwoosh-unity-sample.git

تكوين المشروع

افتح Assets/PushNotificator.cs وقم بتعيين قيم تهيئة Pushwoosh:

Assets/PushNotificator.cs

Pushwoosh.ApplicationCode = "XXXXX-XXXXX";
Pushwoosh.FcmProjectNumber = "XXXXXXXXXXXX";

استبدل قيم ApplicationCode و FcmProjectNumber بـ Pushwoosh App Code و Firebase Project Number الخاصين بك.

iOS

1. تعيين معرف الحزمة (Bundle Identifier)

في ملف تعريف بناء iOS، قم بتعيين Bundle Identifier إلى معرف الحزمة الخاص بك (على سبيل المثال، com.example.pushwoosh).

2. تثبيت التبعيات

بعد إكمال بناء iOS، انتقل إلى دليل ios وقم بتثبيت التبعيات:

pod install

3. تعيين رمز API

افتح ملف ios/Unity-iPhone.xcworkspace في Xcode.
في ملف ios/Unity-iPhone/Info.plist الخاص بك، قم بتعيين مفتاح __PUSHWOOSH_DEVICE_API_TOKEN__ إلى Pushwoosh Device API Token:

info.plist

<key>Pushwoosh_API_TOKEN</key>
<string>__PUSHWOOSH_DEVICE_API_TOKEN__</string>

Android

1. تعيين اسم الحزمة

في ملف تعريف بناء Android، قم بتعيين Package Name إلى اسم حزمة تطبيقك (على سبيل المثال، com.example.pushwoosh).

2. إعداد google-services.json

انسخ ملف google-services.json الخاص بك إلى دليل Assets

3. تعيين رمز API

في ملف Assets/Plugins/Android/AndroidManifest.xml الخاص بك، أضف Pushwoosh Device API Token داخل وسم <application>:

AndroidManifest.xml

<meta-data android:name="com.pushwoosh.apitoken" android:value="__YOUR_DEVICE_API_TOKEN__" />

هام: تأكد من منح الرمز (token) حق الوصول إلى التطبيق الصحيح في لوحة تحكم Pushwoosh الخاصة بك. اعرف المزيد

تشغيل المشروع

1. قم ببناء وتشغيل المشروع.
2. اضغط على زر “Register for push notifications”.
3. امنح الإذن لإشعارات الدفع. سيتم تسجيل الجهاز مع Pushwoosh.

إرسال إشعار دفع

عد إلى لوحة تحكم Pushwoosh و أرسل إشعار دفع إلى جهازك المسجل.