To accurately count the message reach rate and receive rich media messages, the SDK provides the Service Extension API that can be called by the client to listen on message arrivals and receive rich media messages. You can use this feature in the following steps:
Creating a Notification Service Extension Target
1. In the xcode menu bar, select File > New > Target.
Note:
The bundle ID of the primary project must be different from that of the service, and the latter must be prefixed with the former (for example, the former is com.tencent.tpns and the latter is com.tencent.tpns.service).
If the lowest version supported by the target of the primary project is below 10.0, set the extension target system version to 10.0.
If the lowest version supported by the target of the primary project is above 10.0, the extension target system version should be the same as the primary project target version.
2. Enter the Target page, select Notification Service Extension and click Next.
3. Set Product Name and click Finish.
Adding Tencent Push Notification Service Extension Libraries (Three Methods)
Method 1: Integrate through CocoaPods
Download through CocoaPods:
pod 'TPNS-iOS-Extension', '~> Version' // If the version is not specified, the latest version of the local pod TPNS-iOS-Extension will be downloaded.
Use instructions:
1. Create a Notification Service Extension target in Application Extension type, such as XXServiceExtension.
2. Add the configuration item of XXServiceExtension in the Podfile.
The display effect after the configuration item is added in the Podfile is as shown below:
target `XXServiceExtension'do
platform:ios,'10.0'
pod 'TPNS-iOS-Extension' , '~> Version' // The version must be consistent with the primary SDK (TPNS-iOS) version.
To get AccessID and AccessKey, go to the Tencent Push Notification Service console, choose Product Management, and click Configuration Management in the record of a target product. Then you can find AccessID and AccessKey on the page displayed.
4. Run the new_tpns_svc_ext command to verify the result.If the following result is displayed after the new_tpns_svc_ext command is run in the terminal, the notification extension plugin is successfully integrated.
TPNS service auto coding done!
New TPNSService Extension Success
Upgrading new_tpns_svc_ext
When a new version of the SDK notification extension plugin is released, you can run the following command in the terminal for upgrade:
brew update && brew reinstall new_tpns_svc_ext
Note:
You can view the release notes of the latest version in SDK for iOS.
Currently, the HomeBrew command new_tpns_svc_ext supports integrating only the notification service extension plugin TPNSService but not basic push capabilities.
Directions
Calling the SDK's statistics reporting API
1. Import the header file NotificationService into the notification extension class XGExtension.h.
2. Call the following sample code in the callback method didReceiveNotificationRequest:withContentHandler:
/**
@brief //Tencent Push Notification Service processes rich media notifications and device-reached messages, that is, message receipts.
@param request //Push request
@param accessID //Tencent Push Notification Service application `AccessID`
@param accessKey //Tencent Push Notification Service application `AccessKey`
@param handler //Callback of processing messages. Process the associated rich media file in the callback method.
self.contentHandler(self.bestAttemptContent);// If you need to add business logic before the notification pops up, add it before calling ContentHandler.
}];
}
Integration Verification
After completing the integration as instructed above, you can verify whether the extension plugin is successfully integrated in the following steps:
1. Close the application and push a notification message to the phone.
2. Without clicking the message, check whether the message arrives on the phone in the console.
If there is arrival data, the integration is successful.
Debugging
If the device receives the pushed message but there is no arrival data, troubleshoot as follows:
1. Run the primary target (demo example in the figure).
2. Attach the implementation target (TPNSService-Cloud in the demo) of UNNotificationServiceExtension to the primary target by PID or Name.
3. Add breakpoints at code lines 34 and 38 as shown in the figure, and send a notification for debugging. Note that the notification must be sent through the Apple Push Notification service (APNs) channel and that the mutable-content field in the notification content must be 1 (since Tencent Push Notification Service SDK v1.2.8.0, the APNs channel is used by default in the background, and the Tencent Push Notification Service channel is used in the foreground. To debug the notification service extension plugin, you need to make the application run in the background). If the breakpoints are executed, the debugging is successful. Otherwise, stop all targets and start over from step 1.
FAQs
Why is there no arrival report after I sent a notification?
The notification service extension plugin must be integrated for client arrival reporting. If no arrival data is reported after integration, check whether AccessID and AccessKey of the primary project are consistent with those of the notification service extension plugin and whether the mutable-content field in the notification content in the web console or RESTful API is 1.
Only when the two conditions checked are met, the notification service extension plugin on the client will be run, and arrival data will be reported.
