HNKWordLookup1.1.5

HNKWordLookup1.1.5

×

测试已测试✗
Lang语言 Obj-CObjective C
许可证 MIT
发布最后发布2015年4月

由 Harlan Kellaway 维护。

 
依赖
AFNetworking~> 2.5
Mantle~> 1.5
 

HNKWordLookup1.1.5

  • 作者
  • Harlan Kellaway

HNKWordLookup 是一个 Cocoapod，它执行标准的英语词典查询，如定义、发音、随机单词和每日一词。

通信

入门

Podfile

platform :ios, '7.0'
pod "HNKWordLookup", "~> 1.1"

API 密钥

HNKWordLookup 使用Wordnik API进行查询。您需要 Wordnik API 密钥才能使用 HNKWordLookup。

  • 创建Wordnik 账户
  • 一旦激活，您可以在您的设置页面找到 API 密钥

类

  • HNKLookup
  • HNKWordDefinition
  • HNKWordPronunciation
  • HNKWordOfTheDay

使用

设置

在向 HNKLookup 提供您的 Wordnik API 密钥（请参阅 入门）之前，无法发出请求。一旦您获得了 API 密钥，您可以通过调用 sharedInstanceWithAPIKey（通常在 AppDelegate 内部）来设置 HNKLookup 以供使用。

[HNKLookup sharedInstanceWithAPIKey:@"YOUR_API_KEY"];

您应该将 YOUR_API_KEY 替换为您的 Wordnik API 密钥。

查询

HNKLookup 负责处理任何信息查询。完成 设置 后，可以对 [HNKLookup sharedInstance] 发出查询请求。

查找定义

[[HNKLookup sharedInstance] definitionsForWord:@"center" completion:^(NSArray *definitions, NSError *error) {
    if (error) {
        NSLog(@"ERROR: %@", error);
    } else {
        for (HNKWordDefinition *definition in definitions) {
            NSLog(@"%@", definition);
        }
    }
}];

使用特定 partsOfSpeech 查找定义

注意：参数 partsOfSpeech 可以接受任意数量的 HNKWordDefinitionPartOfSpeech 类型的值，值之间由 | 符号分隔。

[[HNKLookup sharedInstance] definitionsForWord:@"center" 
                                 withPartsOfSpeech:HNKWordDefinitionPartOfSpeechNoun | HNKWordDefinitionPartOfSpeechVerbTransitive
                                        completion:^(NSArray *definitions, NSError *error) {
    if (error) {
        NSLog(@"ERROR: %@", error);
    } else {
        for (HNKWordDefinition *definition in definitions) {
            NSLog(@"%@", definition);
        }
    }
}];

查找发音

[[HNKLookup sharedInstance] pronunciationsForWord:@"orange" completion:^(NSArray *pronunciations, NSError *error) {
    if (error) {
        NSLog(@"ERROR: %@", error);
    } else {
        for (HNKWordPronunciation *pronunciation in pronunciations) {
            NSLog(@"%@", pronunciation);
        }
    }
}];

查找随机单词

[[HNKLookup sharedInstance] randomWordWithCompletion:^(NSString *randomWord, NSError *error) {
    if (error) {
        NSLog(@"ERROR: %@", error);
    } else {
        NSLog(@"%@", randomWord);
    }
}];

查找每日一词

[[HNKLookup sharedInstance] wordOfTheDayWithCompletion:^(HNKWordOfTheDay *wordOfTheDay, NSError *error) {
    if (error) {
        NSLog(@"ERROR: %@", error);
    } else {
        NSLog(@"%@", wordOfTheDay);
    }
}];

查找特定日期的每日一词

[[HNKLookup sharedInstance] wordOfTheDayForDate:[NSDate date] completion:^(HNKWordOfTheDay *wordOfTheDay, NSError *error) {
    if (error) {
        NSLog(@"ERROR: %@", error);
    } else {
        NSLog(@"%@", wordOfTheDay);
    }
}];

代理方法

实现 HNKLookupDelegate 协议的类可以访问代理方法。

可选代理方法

(BOOL)shouldDisplayNetworkActivityIndicator

此方法的返回值决定了在 HNKLookup 进行网络请求时，状态栏中的活动指示器是否显示。默认值为 NO。

若要显示活动指示器，实现 HNKLookupDelegate 协议的类应包含以下方法调用

- (BOOL)shouldDisplayNetworkActivityIndicator {
  return YES;
}

鸣谢

HNKWordLookup 由 Harlan Kellaway 创建，并使用了 Wordnik API。

许可

HNKWordLookup 在 MIT 协议下可用。有关更多信息，请参阅 LICENSE 文件。