เริ่มต้นใช้งาน Unity SDK ฉบับย่อ

เริ่มต้นใช้งาน Pushwoosh Unity SDK ด้วยตัวอย่างที่รวดเร็วและง่ายดายนี้

ข้อกำหนดเบื้องต้น

ในการผสาน Pushwoosh Unity SDK เข้ากับแอปของคุณ คุณจะต้องมีสิ่งต่อไปนี้:

ข้อกำหนด

• บัญชี Pushwoosh
• โปรเจกต์ Pushwoosh ที่ตั้งค่าไว้ในบัญชีของคุณ
• สำหรับการผสานรวม iOS:
  • แพลตฟอร์ม iOS ที่กำหนดค่าให้ส่ง push notifications เราขอแนะนำให้ใช้ การกำหนดค่าการยืนยันตัวตนโดยใช้โทเค็น (Token-Based Authentication) เนื่องจากเป็นวิธีที่ง่ายที่สุด
  • ในระหว่างการตั้งค่า ให้ตั้งค่า Gateway เป็น Sandbox เพื่อส่ง push ไปยัง simulator
• สำหรับการผสานรวม Android:
  • แพลตฟอร์ม Android ที่กำหนดค่าแล้ว
  • project number (หรือที่เรียกว่า Sender ID), ไฟล์ google-services.json และ package name จากโปรเจกต์ Firebase ของคุณ
  • โปรเจกต์ Firebase ที่เชื่อมต่อกับแอปพลิเคชัน Android ของคุณ ทำตาม คู่มือการตั้งค่า Firebase หากจำเป็น
• Pushwoosh Application Code และ Pushwoosh Device API Token ของคุณจาก Pushwoosh Control Panel สำหรับแอปพลิเคชันของคุณ

ดาวน์โหลดโปรเจกต์ตัวอย่าง

โคลน repository ของโปรเจกต์ตัวอย่าง:

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

ในโปรไฟล์ build ของ iOS ให้ตั้งค่า Bundle Identifier เป็น bundle ID ของคุณ (เช่น com.example.pushwoosh)

2. ติดตั้ง dependencies

หลังจาก build iOSเสร็จสิ้น ให้ไปที่ไดเรกทอรี ios และติดตั้ง dependencies:

pod install

3. ตั้งค่า API Token

เปิดไฟล์ 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. ตั้งค่า package name

ในโปรไฟล์ build ของ Android ให้ตั้งค่า Package Name เป็น package name ของแอปคุณ (เช่น com.example.pushwoosh)

2. ตั้งค่า google-services.json

คัดลอกไฟล์ google-services.json ของคุณไปยังไดเรกทอรี Assets

3. ตั้งค่า API Token

ในไฟล์ 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 Control Panel ของคุณ เรียนรู้เพิ่มเติม

รันโปรเจกต์

1. Build และรันโปรเจกต์
2. แตะปุ่ม “Register for push notifications”
3. ให้สิทธิ์สำหรับการแจ้งเตือนแบบพุช อุปกรณ์จะถูกลงทะเบียนกับ Pushwoosh

ส่งการแจ้งเตือนแบบพุช

กลับไปที่ Pushwoosh Control Panel และ ส่งการแจ้งเตือนแบบพุช ไปยังอุปกรณ์ที่ลงทะเบียนของคุณ