# การตั้งค่า Badges

<Aside type="note">
หากต้องการตั้งค่า Badges สำหรับปลั๊กอิน Cordova หรือ React Native โปรดดูคู่มือที่เกี่ยวข้อง:

* [Badges สำหรับ Cordova](/th/developer/pushwoosh-sdk/cross-platform-frameworks/cordova/setting-up-badges-for-cordova)
* [Badges สำหรับ React Native](/th/developer/pushwoosh-sdk/cross-platform-frameworks/react-native/setting-up-badges-for-react-native)
</Aside>

ตั้งแต่ Pushwoosh iOS SDK เวอร์ชัน 6.4.0 เป็นต้นไป กระบวนการจัดการและตั้งค่า Badges ผ่าน push notifications ได้มีการเปลี่ยนแปลง

หากก่อนหน้านี้คุณเคยใช้ตัวเลข Badges เพื่อแสดงจำนวน push notifications ที่ได้รับในแอปพลิเคชันของคุณ คุณจะต้องย้ายไปใช้ iOS SDK เวอร์ชันใหม่ (6.4.0 หรือใหม่กว่า) เวอร์ชันเก่าจะยังคงรองรับจนถึงสิ้นไตรมาสที่สองของปี 2022

## อะไรเป็นตัวกำหนดค่า Badge

Badge จะมาจากตัว push เองเสมอ ไม่มีฟีเจอร์ใดของ Pushwoosh ที่ตั้งค่าหรือล้างค่านี้ด้วยตัวเอง การส่ง `"ios_badges"` ในคำขอ [`/createMessage`](/th/developer/api-reference/messages-api/#createmessage) (หรือฟิลด์ **badges** ใน Control Panel) จะเป็นการตั้งค่าทั้ง `aps.badge` (ค่าสัมบูรณ์) และ `aps.pw_badge` (ค่าส่วนต่าง) ใน payload ของ iOS ส่วน Android จะมีค่าที่เทียบเท่ากันใน `pw_badges` และต้องใช้โมดูล [`com.pushwoosh:pushwoosh-badge`](/th/developer/pushwoosh-sdk/android-sdk/customizing-android-sdk-50/#using-badge-number-on-android) เพื่อนำไปใช้กับ launchers ที่รองรับ การบันทึก push ไปยัง [Message Inbox](/th/developer/guides/message-inbox/) จะไม่เป็นการตั้งค่าหรือเปลี่ยนแปลง Badge ทั้งสองอย่างเป็นผลกระทบที่แยกจากกันของ push เดียวกัน

<Aside type="caution">
ค่า Badge แบบส่วนต่าง **+1**/**-1** จะถูกนำไปใช้โดย Notification Service Extension เท่านั้น และจะใช้ได้ก็ต่อเมื่อมีการติดตั้งและกำหนดค่าด้วย App Group ที่ตรงกันตามที่อธิบายไว้ด้านล่าง หากไม่มีการตั้งค่าดังกล่าว ระบบปฏิบัติการจะใช้ค่า `aps.badge` แบบสัมบูรณ์จาก payload ตามที่เป็นอยู่ จะไม่มีการเพิ่มค่าอัตโนมัติ
</Aside>

## วิธีการตั้งค่า Badges

ในการตั้งค่า Badges ให้ทำตามขั้นตอนด้านล่าง:

1. เพิ่ม Notification Service Extension (File -> New -> Target...)

<img src="/shared-7.webp" alt=""/>

2. เลือก "Notification Service Extension"

<img src="/ios-push-notifications-setting-up-badges-1.webp" alt="การเพิ่ม Notification Service Extension"/>

3. แทนที่คลาส `NotificationService` ที่สร้างขึ้นด้วยคลาสย่อยของ `PushwooshNotificationServiceExtension` ทาง Pushwoosh จะจัดการการนับ Badge, event การส่ง, การดาวน์โหลดไฟล์แนบ และการจัดการเมื่อหมดเวลาให้คุณ:

<Tabs>
<TabItem label="Swift">
```swift
import PushwooshFramework

class NotificationService: PushwooshNotificationServiceExtension {}
```
</TabItem>

<TabItem label="Objective-C">
```objective-c
#import <PushwooshFramework/PushwooshFramework.h>

@interface NotificationService : PushwooshNotificationServiceExtension
@end

@implementation NotificationService
@end
```
</TabItem>
</Tabs>

4. เพิ่มความสามารถ App Groups ให้กับ **ทั้งสอง** targets — แอปหลักและ Notification Service Extension — และใช้ App Group เดียวกันสำหรับทั้งสอง

5. เพิ่ม App Group ID ไปยัง `info.plist` ของ **แอปหลัก**:

```
<key>PW_APP_GROUPS_NAME</key>
<string>group.com.example.demoapp_example</string>
```

<img src="/shared-12.webp" alt="Info.plist"/>

extension จะสืบทอดค่านี้มาจากแอปโฮสต์ ดังนั้นคุณไม่จำเป็นต้องใส่ซ้ำใน `info.plist` ของ extension — ให้เพิ่มเข้าไปในกรณีที่ต้องการจะแทนที่ค่าของโฮสต์เท่านั้น

หากคุณไม่ต้องการใช้ไฟล์ **info.plist** คุณสามารถระบุ App Group ในโค้ดได้โดยการ override `pushwooshAppGroupsName` ในคลาส NotificationServiceExtension ของคุณ:

<Tabs>
<TabItem label="Swift">
```swift
override func pushwooshAppGroupsName() -> String? {
    "group.com.example.demoapp_example"
}
```
</TabItem>

<TabItem label="Objective-C">
```objective-c
- (NSString *)pushwooshAppGroupsName {
    return @"group.com.example.demoapp_example";
}
```
</TabItem>
</Tabs>

<LinkCard title="ตัวอย่าง" href="https://github.com/Pushwoosh/pushwoosh-quickstart-ios/tree/main/badges/badges" />


## ส่ง push notification พร้อม Badges

หากคุณต้องการส่ง push notification พร้อม Badges จาก Pushwoosh Control Panel เพียงแค่เพิ่มค่า Badge ที่ต้องการลงในช่องข้อความ **badges** ดังที่แสดงในภาพด้านล่าง:

<img src="/ios-push-notifications-setting-up-badges-5.webp" alt="ค่า Badges"/>

<Aside type="note">
คุณสามารถใช้รูปแบบค่าต่อไปนี้เพื่อส่ง Badges ได้อย่างถูกต้อง: **+1, -1 หรือ 5** หากคุณต้องการเพิ่มค่า Badge ให้ใช้เครื่องหมาย **"+"** หากคุณต้องการลดค่า Badges ให้ใช้เครื่องหมาย **"-"** คุณยังสามารถตั้งค่าตัวเลขที่แน่นอนได้โดยใช้ เช่น **5** โดยไม่มีเครื่องหมาย
</Aside>

## แบ่งปันความคิดเห็นของคุณกับเรา

ความคิดเห็นของคุณช่วยให้เราสร้างประสบการณ์ที่ดีขึ้น เราจึงยินดีที่จะรับฟังจากคุณหากคุณมีปัญหาใดๆ ในระหว่างขั้นตอนการผสานรวม SDK หากคุณประสบปัญหาใดๆ โปรดอย่าลังเลที่จะแบ่งปันความคิดของคุณกับเรา [ผ่านแบบฟอร์มนี้](https://docs.google.com/forms/d/e/1FAIpQLSd\_0b8jwn-V\_JmoPLIxIFYbHACCQhrzidOZV3ELywoQPXRSxw/viewform)