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

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

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

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

المتطلبات

• حساب Pushwoosh.
• مشروع Pushwoosh مُعد في حسابك.
• لتكامل iOS:
  • منصة iOS مُعدة لإرسال إشعارات الدفع (push notifications). نوصي باستخدام إعداد المصادقة المستندة إلى الرمز المميز (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 المميز من لوحة تحكم Pushwoosh لتطبيقك.

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

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

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. بناء وتثبيت التبعيات

يتضمن المشروع النموذجي إصدارًا من Pushwoosh Unity SDK أقدم من 6.3.0، مع iOS SDK الأصلي 6.7.18. ويحصل على iOS SDK الأصلي باستخدام CocoaPods عبر External Dependency Manager for Unity (EDM4U). قم ببناء مشروع iOS من Unity. ثم انتقل إلى دليل مشروع Xcode الذي تم إنشاؤه وقم بتثبيت تبعيات CocoaPods:

cd ios && pod install

في مشروعك الخاص الذي يستخدم Pushwoosh Unity SDK 6.3.0 أو أحدث، تتم إضافة iOS SDK الأصلي باستخدام Swift Package Manager افتراضيًا، ولا تحتاج إلى تشغيل pod install. راجع اختيار طريقة إضافة iOS SDK.

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 إلى جهازك المسجل.