iOS Native SDK

Search…
iOS Native SDK
Các hàm trong iOS Native SDK
initWithClientKey
Khởi tạo Pushdy SDK với Client Key. Bạn có thể sao chép Client Key tại Dashboard của Pushdy sau khi bạn tạo ứng dụng. Mỗi ứng dụng sẽ có 1 Client Key duy nhất.
Hàm initWithClientKey được sử dụng trong hàm didFinishLaunchingWithOptions trong file AppDelegate của bạn.
Objective-C
Swift
1
NSString *clientKey = @"YOUR_CLIENT_KEY";
2
[Pushdy initWithClientKey:clientKey delegate:self launchOptions:launchOptions];
Copied!
1
let clientKey = "YOUR_CLIENT_KEY"
2
Pushdy.initWith(clientKey: clientKey, delegate: self, launchOptions: launchOptions)
Copied!
setDeviceID
Bạn có thể tuỳ chỉnh Device ID theo logic của bạn. Nếu bạn không sử dụng hàm này, Device ID sẽ được tự động sinh ra để đảm bảo định danh user là duy nhất.
Hàm này phải được gọi ngay trước hàm initWithClientKey khi bạn khởi tạo Pushdy SDK để đảm bảo Custom Device ID được lưu lại trước khi Pusdy SDK gửi yêu cầu tới máy chủ.
Objective-C
Swift
1

NSString *customDeviceID = @"YOUR CUSTOM ID";
2
[Pushdy setDeviceID:customDeviceID];
Copied!
1
let customDeviceID = "YOUR CUSTOM ID"
2
Pushdy.setDeviceID(customDeviceID)
Copied!
getDeviceID
Với hàm này bạn có thể truy xuất Device ID của bạn.
Objective-C
Swift
1
NSString *yourDeviceID = [Pushdy getDeviceID]
Copied!
1
let yourDeviceID = Pushdy.getDeviceID()
Copied!
registerForPushNotification
Sử dụng để hiển thị cửa sổ xin quyền Push Notification. Để tăng tỷ lệ user đồng ý nhận Push Notification, bạn nên gọi hàm này sau khi đã hiển thị đầy đủ thông tin về lợi ích của việc bật Push Notification với user.
Objective-C
Swift
1
[Pushdy registerForPushNotifications];
Copied!
1
Pushdy.registerForPushNotifications()
Copied!
checkNotificationEnabled
Kiểm tra xem người dùng có bật Push Notification cho iOS App của bạn hay không.
Objective-C
Swift
1
[Pushdy checkNotificationEnabled:^(BOOL enabled) {
2
    // ...
3
}];
Copied!
1
Pushdy.checkNotificationEnabled { (enabled:Bool) in
2
    // ...
3
}
Copied!
getDeviceToken
Lấy APNs Token. Token này chỉ có khi người dùng bật Push Notification cho App.
Objective-C
Swift
1
NSString *deviceToken = [Pushdy getDeviceToken];
Copied!
1
let deviceToken = Pushdy.getDeviceToken()
Copied!
getPendingNotification
Lấy Notification mới nhất từ danh sách các Notification chưa được xử lý.
Objective-C
Swift
1
NSDictionary *latestNotification = [Pushdy getPendingNotification];
Copied!
1
let latestNotification = Pushdy.getPendingNotification()
Copied!
getPendingNotifications
Lấy danh sách toàn bộ Notification từ danh sách hàng đợi chưa được xử lý.
Objective-C
Swift
1
NSArray *pendingNotifications = [Pushdy getPendingNotifications];
Copied!
1
let pendingNotifications = Pushdy.getPendingNotifications()
Copied!
setAttribute
Tracking dữ liệu để gửi lên Pushdy nhằm phục vụ phân đoạn người dùng khi gửi Push. Với hàm này, dữ liệu mới sẽ đè lên dữ liệu cũ. Bạn có thể xem thêm chi tiết cách định nghĩa thuộc tính tại phần Tạo thuộc tính.
Objective-C
Swift
1
[Pushdy setAttribute:@"your_attribute_name" value:@"your_value" error:nil];
Copied!
1
try? Pushdy.setAttribute("your_attribute_name", value: "your_value") 
Copied!
pushAttribute
Tương tự hàm setAttribute nhưng chỉ hoạt động với thuộc tính được định nghĩa là kiểu mảng (Array). Mảng giá trị mới sẽ được gắn thêm vào sau giá trị cũ.
Objective-C
Swift
1
NSArray *your_values_array = @[@"new_value_1", @"new_value_2"];
2
[Pushdy pushAttribute:@"your_attribute_name" value:your_values_array error:nil];
Copied!
1
let your_values_array:[String] = [
2
    "new_value_1",
3
    "new_value_2"
4
]
5
try? Pushdy.pushAttribute("your_attribute_name", value: your_values_array)
Copied!
getPlayerId
Lấy Player ID của người dùng, ID này do Pushdy sinh ra cho mỗi người dùng đầu cuối. Chú ý, mỗi 1 thiết bị sẽ có 1 Player ID duy nhất, trường hợp gỡ ứng dụng và cài lại thì Player ID vẫn giữ nguyên. Player ID chỉ thay đổi khi bạn thay đổi Device ID bằng hàm setDeviceID. 
Objective C
Swift
1
NSString *playerID = [Pushdy getPlayerID];
Copied!
1
let playerID = Pushdy.getPlayerID()
Copied!
Các Delegation trong iOS Native SDK
readyForHandlingNotification
Nếu hàm trả về giá trị là false có nghĩa là Push Notification sẽ không được xử lý ngay tại thời điểm nhận được mà sẽ được đưa vào hàng đợi. Bạn chỉ có thể lấy và xử lý Push Notification này bằng cách sử dụng hàm getPendingNotification hoặc getPendingNotifications . Mặc định giá trị được trả về sẽ là true, có nghĩa là Push Notification sẽ được xử lý ngay khi Device của bạn nhận được.
Objective-C
Swift
1
(BOOL)readyForHandlingNotification {
2
    BOOL already = YES;
3
    // your custom logic
4
    if (my_screen_name == "tutorial") {
5
        // không hiển thị push ở màn hình Tutorial mà sẽ chủ động hiển thị khi 
6
        // sau khi user hoàn thành tutorial
7
        already = NO;
8
    }
9
    return already;
10
}
Copied!
1
func readyForHandlingNotification() -> Bool {
2
    var already = true
3
    // your custom logic
4
    if (my_screen_name == "tutorial") {
5
        // không hiển thị push ở màn hình Tutorial mà sẽ chủ động hiển thị khi 
6
        // sau khi user hoàn thành tutorial
7
        already = false;
8
    }
9
    return already
10
}
Copied!
onNotificationReceived
Được gọi khi app của bạn nhận được Push Notification. Chú ý, sự kiện này chỉ xảy ra khi App của bạn đang được mở.
Objective-C
Swift
1
(void)onNotificationReceived:(NSDictionary<NSString *,id> *)notification 
2
                                fromState:(NSString *)fromState {
3
    NSLog(@"Received notification from state: %@", fromState);
4
}
Copied!
1
func onNotificationReceived(_ notification: [String : Any], fromState: String) {
2
   print("Received notification from state: \(fromState)")     
3
}
Copied!
onNotificationOpened
Được gọi khi người dùng nhấp vào Push Notification.
Objective-C
Swift
1
(void)onNotificationOpened:(NSDictionary<NSString *,id> *)notification 
2
                                fromState:(NSString *)fromState {
3
    NSLog(@"Opened notification from state: %@", fromState);
4
}
Copied!
1
func onNotificationOpened(_ notification: [String : Any], fromState: String) {
2
     print("Opened notification from state: \(fromState)")     
3
}
Copied!
Một số hàm dùng để tuỳ biến hiển thị Push Notification
setPushBannerAutoDismiss
Bật/tắt tự động ẩn cửa sổ cho Push Notification khi bạn đang mở App. Nếu bạn tắt điều khiển tự động, người dùng sẽ phải chủ động nhấp vào "x" button trên cửa sổ Push để tắt thông báo.
Objective-C
Swift
1
[Pushdy setPushBannerAutoDismiss:TRUE];
Copied!
1
Pushdy.setPushBannerAutoDismiss(true)
Copied!
setPushBannerAutoDismissDuration
Thiết lập thời gian hiển thị cửa sổ Push Notification khi bạn đang mở App. Mặc định, thời gian hiển thị là 5 giây. Hàm này chỉ hoạt động khi bạn bật chức năng tự động ẩn cửa sổ Push.
Objective-C
Swift
1
[Pushdy setPushBannerDismissDuration:5];
Copied!
1
Pushdy.setPushBannerDismissDuration(5)
Copied!
setCustomPushBanner
Tuỳ chỉnh cửa sổ hiển thị Push Notification.
Objective-C
Swift
1
[Pushdy setCustomPushBanner:yourUIView];
Copied!
1
Pushdy.setCustomPushBanner(yourUIView)
Copied!
setCustomMediaKey
Tuỳ chỉnh Json key cho media url để hiển thị ảnh trên cửa sổ Push Notification khi đang bật App. Mặc định, media_url sẽ là key được sử dụng.
Objective-C
Swift
1
[PDYNotificationView setCustomMediaKey:@"your_custom_media_key"];
Copied!
1
PDYNotificationView.setCustomMediaKey("your_custom_media_key")
Copied!