Donky-SignalR 4.8.2.0

Donky-SignalR 4.8.2.0

×

测试已测试✗
语言语言 Obj-CObjective C
许可证 MIT
发布上次发布2016年9月

由 Donky Networks Ltd 维护。

 
依赖项
SignalR-ObjC>= 0
Donky-Core-SDK>= 0
 

Donky-SignalR 4.8.2.0

Donky Modular SDK (V2.8.2.0)

Donky iOS SDK 是一个用于将推送通知和丰富内容服务添加到您的应用程序的工具包。有关详细文档、教程和指南，请访问我们的在线文档。

要求

Donky模块SDK的最小技术要求是

  • Xcode 5.0+
  • iOS 7.0+
  • Arc必须启用。

请在此处阅读我们的完整文档 http://docs.mobiledonky.com

作者

Donky Networks Ltd, [email protected]

许可证

DonkySDK-iOS-Modular 在 MIT 许可下可用。有关更多信息，请参阅 LICENSE 文件。

安装

请使用以下方法之一进行安装：

克隆 Git 仓库

git clone [email protected]:Donky-Network/DonkySDK-iOS-Modular.git

使用 CocoaPods

Please see below for all the information specific to the CocoaPods

支持

如果您在集成或使用此 SDK 时遇到任何问题，请联系 [email protected]

贡献

我们接受 Pull 请求！

Donky-Core-SDK

使用

只有当这是您将使用 SDK 的唯一部分时，才添加此内容到您的 'PodFile' 中。如果您要使用任何额外的可选模块，添加此内容到 'Podfile' 中不是必需的。

匿名初始化

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    //Start analytics (optional)
    [[DCAAnalyticsController sharedInstance] start];

    //Initialise Donky with API key.
    [[DNDonkyCore sharedInstance] initialiseWithAPIKey:@"API-KEY"];
    return YES;
}

使用已知用户初始化

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    //Start analytics (optional)
    [[DCAAnalyticsController sharedInstance] start];

    //Create a new user and populate with details. Country code is optional is NO mobile number is provided. If a 
    //mobile number is provided then a country code is mandatory. Failing to provide a country code that matches the
    //mobile number will result in a server validation error. 
    DNUserDetails *userDetails = [[DNUserDetails alloc] initWithUserID:@"" 
                                                           displayName:@""
                                                          emailAddress:@"" 
                                                          mobileNumber:@"" 
                                                           countryCode:@"" 
                                                             firstName:@"" 
                                                              lastName:@"" 
                                                              avatarID:@"" 
                                                          selectedTags:@[] 
                                                  additionalProperties:@{}];

    //Initialise Donky with API key.
    [[DNDonkyCore sharedInstance] initialiseWithAPIKey:@"API-KEY" userDetails:userDetails success:^(NSURLSessionDataTask *task, id responseData) {
        NSLog(@"Successfully Initialised with user...");
    } failure:^(NSURLSessionDataTask *task, NSError *error) {
        NSLog(@"%@", [error localizedDescription]);
    }];
    return YES
}

您还必须调用以下您应用程序的代理，以确保能够快速接收和处理的自定义内容通知

为确保您的设备令牌发送到Donky网络

- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
    [DNNotificationController registerDeviceToken:deviceToken];
}

为了处理传入的通知，使用此方法允许您的应用程序处理内容启用通知

- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult result))completionHandler {
    [DNNotificationController didReceiveNotification:userInfo handleActionIdentifier:nil completionHandler:^(NSString *string) {
        completionHandler(UIBackgroundFetchResultNewData);
    }];
}

处理交互式通知（仅限iOS 8+）

- (void)application:(UIApplication *)application handleActionWithIdentifier:(NSString *)identifier forRemoteNotification:(NSDictionary *)userInfo completionHandler:(void (^)())completionHandler {
    [DNNotificationController didReceiveNotification:userInfo handleActionIdentifier:identifier completionHandler:^(NSString *string) {
        completionHandler();
    }];
}

示例

示例项目可以在

│
├───src
    ├───workspaces
        ├───Donky Core SDK Demo

要求

  • iOS 7.0+
  • Arc必须启用。

第三方依赖

AFNetworking

安装

Donky-Core-SDK通过CocoaPods提供。要安装它，只需将以下行添加到您的Podfile中

pod "Donky-Core-SDK"

Donky-Push

使用

使用简单推送模块使您的应用程序能够接收简单推送消息。

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

    //Start analytics (optional)
    [[DCAAnalyticsController sharedInstance] start];

    //Start push logic:
    [[DPPushNotificationController sharedInstance] start];

    //Initialise Donky
    [[DNDonkyCore sharedInstance] initialiseWithAPIKey:@"API-KEY"];

    return YES;
}

您还必须调用以下您的应用代理

为确保您的设备令牌发送到Donky网络

- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
    [DNNotificationController registerDeviceToken:deviceToken];
}

为了处理传入的通知，使用此方法允许您的应用程序处理内容启用通知

- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult result))completionHandler {
    [DNNotificationController didReceiveNotification:userInfo handleActionIdentifier:nil completionHandler:^(NSString *string) {
        completionHandler(UIBackgroundFetchResultNewData);
    }];
}

处理交互式通知（仅限iOS 8+）

- (void)application:(UIApplication *)application handleActionWithIdentifier:(NSString *)identifier forRemoteNotification:(NSDictionary *)userInfo completionHandler:(void (^)())completionHandler {
    [DNNotificationController didReceiveNotification:userInfo handleActionIdentifier:identifier completionHandler:^(NSString *string) {
        completionHandler();
    }];
}

示例

示例项目可以在

│
├───src
    ├───workspaces
        ├───Donky Simple Push Logic Demo

要求

  • iOS 7.0+
  • Arc必须启用。
  • 交互式通知需要iOS 8.0以上。

安装

pod "Donky-Push"

Pod依赖

在Podfile中包含此内容将自动拉取以下其他模块，因为它们有硬依赖。无需手动调用以下任何内容

  • Donky核心SDK
  • Donky通用消息逻辑

Donky-RichMessage-Logic

使用

使用富消息模块使您的应用程序能够从网络接收富消息并将它们保存到Donky的本地数据库中。您可以通过 Objective-C DRLogicMainController 中提供的API检索和删除消息。

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.

    //Start analytics controller (optional)
    [[DCAAnalyticsController sharedInstance] start];

    //Start the Rich Logic
    [[DRLogicMainController sharedInstance] start];

    //Initialise Donky
    [[DNDonkyCore sharedInstance] initialiseWithAPIKey:@"API-Key"];

    return YES;
}

您还必须调用以下您的应用代理

为确保您的设备令牌发送到Donky网络

- (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
    [DNNotificationController registerDeviceToken:deviceToken];
}

为了处理传入的通知，使用此方法允许您的应用程序处理内容启用通知

- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo fetchCompletionHandler:(void (^)(UIBackgroundFetchResult result))completionHandler {
    [DNNotificationController didReceiveNotification:userInfo handleActionIdentifier:nil completionHandler:^(NSString *string) {
        completionHandler(UIBackgroundFetchResultNewData);
    }];
}

处理交互式通知（仅限iOS 8+）

- (void)application:(UIApplication *)application handleActionWithIdentifier:(NSString *)identifier forRemoteNotification:(NSDictionary *)userInfo completionHandler:(void (^)())completionHandler {
    [DNNotificationController didReceiveNotification:userInfo handleActionIdentifier:identifier completionHandler:^(NSString *string) {
        completionHandler();
    }];
}

示例

示例项目可以在

│
├───src
    ├───workspaces
        ├───Donky Rich Message Logic Demo

要求

  • iOS 7.0+
  • Arc必须启用。

安装

pod "Donky-RichMessage-Logic"

Pod依赖

在Podfile中包含此内容将自动拉取以下其他模块，因为它们有硬依赖。无需手动调用以下任何内容

  • Donky核心SDK
  • Donky通用消息逻辑

Donky-RichMessage-Inbox

使用

使用富消息模块使您的应用程序能够在我们的预构建UI中接收和显示富消息。

示例

示例项目可以在

│
├───src
    ├───workspaces
        ├───Donky Rich Message Inbox Demo

要求

  • iOS 7.0+
  • Arc必须启用。

安装

pod "Donky-RichMessage-Inbox"

Pod依赖

在Podfile中包含此内容将自动拉取以下其他模块，因为它们有硬依赖。无需手动调用以下任何内容

  • Donky核心SDK
  • Donky富消息逻辑
  • Donky通用消息逻辑
  • Donky通用消息UI

Donky自动化逻辑

用法

使用自动化模块可以触发在“Campaign Builder/Donky Control”上设置的营销活动。（在此处）.

正常启动Donky SDK和分析控制器。

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.

    //Start analytics module (optional)
    [[DCAAnalyticsController sharedInstance] start];

    //Initialise Donky
    [[DNDonkyCore sharedInstance] initialiseWithAPIKey:@"API-KEY"];

    return YES;
}

要触发一个触发器，可以使用以下任何一种方法

[DAAutomationController executeThirdPartyTriggerWithKey:@"Trigger-Key" customData:@{}];
[DAAutomationController executeThirdPartyTriggerWithKeyImmediately:@"Trigger-Key" customData:@{}];

示例

示例项目可以在

│
├───src
    ├───workspaces
        ├───Donky Automation Demo

需求

  • iOS 7.0+
  • Arc必须启用。

安装

pod "Donky-Automation-Logic"

Pod 依赖

在Podfile中包含此内容将自动拉取以下其他模块，因为它们有硬依赖。无需手动调用以下任何内容

  • Donky核心SDK

Donky-通用消息-音频

用法

此模块的使用允许您为各种消息类型保存音频文件，并在收到该类型的消息时自动播放它们。（在此处）.

启动控制器

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.

    [[DAMainController sharedInstance] start];

    //Other donky modules or custom code:

    return YES;
}

要设置声音文件，此方法接受一个指向文件的NSURL。

[[DAMainController sharedInstance] setAudioFile:<#(NSURL *)#> forMessageType:<#(DonkyAudioMessageTypes)#>];

要播放声音文件

[[DAMainController sharedInstance] playAudioFileForMessage:<#(DonkyAudioMessageTypes)#>];

示例

│
├───src
    ├───workspaces
        ├───Donky Audio

需求

  • iOS 7.0+
  • Arc必须启用。

安装

pod "Donky-CommonMessaging-Audio"

Pod 依赖

无

Donky核心-排队

用法

使用此模块允许您在不需要实现回调或处理改变本地和网络状态时的时序问题时对账户控制器方法进行多次调用。

此模块覆盖以下方法内部的

DNSequencingAccountController
+ (void)updateAdditionalProperties:(NSDictionary *)newAdditionalProperties success:(DNNetworkSuccessBlock)successBlock failure:(DNNetworkFailureBlock)failureBlock;
+ (void)saveUserTags:(NSMutableArray *)tags success:(DNNetworkSuccessBlock)successBlock failure:(DNNetworkFailureBlock)failureBlock;
+ (void)updateUserDetails:(DNUserDetails *)userDetails success:(DNNetworkSuccessBlock)successBlock failure:(DNNetworkFailureBlock)failureBlock;
+ (void)updateRegistrationDetails:(DNUserDetails *)userDetails deviceDetails:(DNDeviceDetails *)deviceDetails success:(DNNetworkSuccessBlock)successBlock failure:(DNNetworkFailureBlock)failureBlock;
+ (void)updateDeviceDetails:(DNDeviceDetails *)deviceDetails success:(DNNetworkSuccessBlock)successBlock failure:(DNNetworkFailureBlock)failureBlock;

示例

需求

  • iOS 7.0+
  • Arc必须启用。

安装

pod "Donky-Core-Sequencing"

Pod 依赖

在Podfile中包含此内容将自动拉取以下其他模块，因为它们有硬依赖。无需手动调用以下任何内容

  • Donky核心SDK

Donky-通用消息-逻辑

用法

您永远不需要手动将通用逻辑模块添加到您的应用程序中，它是一个PodSpec依赖项，因此不需要手动添加到您的PodFile中。

Donky-通用消息-UI

用法

您永远不需要手动将通用UI模块添加到您的应用程序中，它是一个PodSpec依赖项，因此不需要手动添加到您的PodFile中。

Donky核心-位置

用法

添加此功能可让您使用Donky的位置和报告功能，请参阅此处