เริ่มต้นใช้งาน 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 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 เป็น bundle ID ของคุณ (เช่น com.example.pushwoosh)

2. Build และติดตั้ง dependencies

โปรเจกต์ตัวอย่างมี Pushwoosh Unity SDK เวอร์ชันก่อน 6.3.0 พร้อม iOS SDK แบบเนทีฟ 6.7.18 ซึ่งรับ iOS SDK แบบเนทีฟผ่าน CocoaPods โดยใช้ External Dependency Manager for Unity (EDM4U) Build โปรเจกต์ iOS จาก Unity จากนั้นไปที่ไดเรกทอรีโปรเจกต์ Xcode ที่สร้างขึ้นและติดตั้ง dependencies ของ 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 ของคุณ เพิ่ม Pushwoosh Device API Token:

Info.plist

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

Android

1. ตั้งค่า package name

ใน Unity ไปที่ Edit > Project Settings > Player > Android > Other Settings และตั้งค่า Package Name เป็น package name ของแอปของคุณ (เช่น com.example.pushwoosh)

2. เพิ่ม google-services.json

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

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. ให้สิทธิ์สำหรับ push notifications อุปกรณ์จะถูกลงทะเบียนกับ Pushwoosh

ส่ง push notification

ไปที่ Pushwoosh Control Panel และ ส่ง push notification ไปยังอุปกรณ์ที่ลงทะเบียนของคุณ