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

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

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

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

المتطلبات

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

تنزيل مشروع المثال

قم باستنساخ مستودع مشروع المثال:

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

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

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

Assets/Scripts/PushNotificator.cs

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

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

iOS

1. تعيين Bundle Identifier

في Unity، انتقل إلى Edit > Project Settings > Player > iOS > Other Settings وقم بتعيين Bundle Identifier إلى معرف الحزمة الخاص بك (على سبيل المثال، com.example.pushwoosh).

2. بناء وتثبيت التبعيات

قم ببناء مشروع iOS من Unity. ثم انتقل إلى دليل مشروع Xcode الذي تم إنشاؤه وقم بتثبيت تبعيات CocoaPods:

cd ios && pod install

3. تعيين API Token

افتح ملف ios/Unity-iPhone.xcworkspace في Xcode. في ملف Info.plist الخاص بك، أضف Device API Token لـ Pushwoosh:

Info.plist

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

Android

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

في Unity، انتقل إلى Edit > Project Settings > Player > Android > Other Settings وقم بتعيين Package Name إلى اسم حزمة تطبيقك (على سبيل المثال، com.example.pushwoosh).

2. إضافة google-services.json

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

3. تعيين API Token

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

AndroidManifest.xml

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

تنبيه

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

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

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

إرسال إشعار Push

انتقل إلى Control Panel الخاص بـ Pushwoosh وقم بـ إرسال إشعار Push إلى جهازك المسجل.