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

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

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

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

<TranslatedFragment id="prerequisites-plugins-unity" />

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

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

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

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

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

```csharp title="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:

```bash
cd ios && pod install
```

###### 3. تعيين API Token

افتح ملف **ios/Unity-iPhone.xcworkspace** في Xcode.
في ملف `Info.plist` الخاص بك، أضف [Device API Token لـ Pushwoosh](/ar/developer/api-reference/api-access-token/#device-api-token):

```xml title="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](/ar/developer/api-reference/api-access-token/#device-api-token) داخل علامة `<application>`:

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

<Aside type="caution">
تأكد من منح الرمز المميز (token) حق الوصول إلى التطبيق الصحيح في Control Panel الخاص بـ Pushwoosh. [اعرف المزيد](/ar/developer/api-reference/api-access-token/#edit-token)
</Aside>

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

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

## إرسال إشعار Push

انتقل إلى Control Panel الخاص بـ Pushwoosh وقم بـ [إرسال إشعار Push](/ar/product/messaging-channels/push-notifications/send-push-notifications/one-time-push) إلى جهازك المسجل.