转载

Objectwitter-C 0.9.1 释出，支持推特卡片式引用功能

#深圳# 6月10日亚马逊AWSome Day云计算免费培训报名中

六周前，Twitter 增加了对推文的卡片式引用 “Quoted Tweet”，该功能能够节省用户转发其他人的推文并添加自己的评论时的字数，同时还能提升所有使用 Twitter 相关产品的用户体验：

最近，Twitter 宣布其更新了它的 API 以向第三方客户端开放此功能，这将允许所有第三方客户端都可以正确地解析并渲染用户的 “Quoted Tweet”：

Objectwitter-C 0.9.1 释出，支持推特卡片式引用功能

Objectwitter-C 此次更新就是增添了对 “Quoted Tweet” 卡片式引用的支持，最新版代码可以在这里获取。

什么是 Objectwitter-C

Objectwitter-C 是一款稳定，成熟，全面的 Twitter REST/Streaming API 的 Objective-C 封装，其封装了 Twitter 的全部公开 API。由@开源中国真理部部长基于 STTwitter 开发，在 STTwitter 对 Twitter REST API 的全面封装的基础上，增添了很多工具类使得 API 更加抽象，易用，并且完全重新设计了 Twitter Streaming API 的封装，利用类似于 NSURLSession / NSURLConnection 的委托模式（delegate）使得用户更容易与 Twitter 流（streaming）API 交互。

Objectwitter-C 不依赖于 AppKit 和 UIKit 即可工作，你可以将该框架用在命令行应用中。你可以把 Objectwitter-C 考虑为 FOSS 版的 Twitter Fabric TwitterKit，但是去掉了 UI 部分并且更加灵活。

安装

将项目目录拖动到你自己的工程中，将你的工程与下列系统框架连接：

Accounts.framework
Social.framework
Twitter.framework (iOS only)
Security.framework (OS X only)

代码片段

初始化 Twitter API 对象：

STTwitterAPI* twitter = [ STTwitterAPI twitterAPIWithOAuthConsumerKey: @""                                                        consumerSecret: @""                                                              username: @""                                                              password: @"" ];

验证凭据：

[ twitter verifyCredentialsWithUserSuccessBlock: ^( NSString* username, NSString* userID )   {  // ...  } errorBlock:   ^( NSError* error )     {    // ...    } ];

抓取时间轴（Timeline）中的推文（tweets）：

[ twitter getHomeTimelineSinceID: nil         count: 100     successBlock: ^( NSArray* statuses )   {  // ...  } errorBlock:   ^( NSError* error )     {    // ...    } ];

App Only 验证：

STTwitterAPI* twitter = [ STTwitterAPI twitterAPIAppOnlyWithConsumerKey: @""                consumerSecret: @"" ]; [ twitter verifyCredentialsWithUserSuccessBlock:  ^( NSString* username, NSString* userID )    {   [ twitter getUserTimelineWithScreenName: @"barackobama"            successBlock:     ^( NSArray* statuses )      {     // ...     } errorBlock:      ^( NSError* error )        {       // ...       } ];   } errorBlock:     ^( NSError* error )      {     // ...     } ];

使用游标（cursor）枚举返回结果：

[ _twitter fetchAndFollowCursorsForResource: @"followers/ids.json"         HTTPMethod: @"GET"         baseURLString: @"https://api.twitter.com/1.1"         parameters: @{@"screen_name":@"0xcharlie"}      uploadProgressBlock: nil       downloadProgressBlock: nil          successBlock: ^( id request, NSDictionary* requestHeaders, NSDictionary* responseHeaders, id response, BOOL morePagesToCome, BOOL* stop )   {  NSLog( @"-- success, more to come: %d, %@", morePagesToCome, response );  }      pauseBlock: ^( NSDate* nextRequestDate )   {  NSLog( @"-- rate limit exhausted, nextRequestDate: %@", nextRequestDate );  }      errorBlock:  ^( id request, NSDictionary* requestHeaders, NSDictionary* responseHeaders, NSError* error )   {  NSLog( @"-- %@", error );  } ];

不同类型的 OAuth 连接：你可以以三种方法初始化 STTwitterAPI 对象：

使用 OS X Preferences 或者 iOS Settings 中的 Twitter 账号
使用你自己指定的 consumer key 和 consumer secret（四种风格）：

获取一个 URL，抓取 PIN 码输入到你的 app 中从而获取 OAuth access token
设置用户名（username）和密码（password），然后使用 XAuth 获取 OAuth access token
直接设置 OAuth token 和 OAuth token secret
打开 Safari 或者使用 UIWebView 实例，执行 Twitter 验证操作然后通过一个定制的 UEL scheme 在你的 app 中直接接收 OAuth access token

使用 Application Only 验证，获取并使用 “bearer token“

有五个 API 对应五种情况：

+ ( STTwitterAPI* ) twitterAPIOSWithFirstAccount; + ( STTwitterAPI* ) twitterAPIWithOAuthConsumerKey: ( NSString* )consumerKey  consumerSecret: ( NSString* )consumerSecret; + ( STTwitterAPI* ) twitterAPIWithOAuthConsumerKey: ( NSString* )consumerKey  consumerSecret: ( NSString* )consumerSecret        username: ( NSString* )username        password: ( NSString* )password; + ( STTwitterAPI* ) twitterAPIWithOAuthConsumerKey: ( NSString* )consumerKey  consumerSecret: ( NSString* )consumerSecret      oauthToken: ( NSString* )oauthToken                                   oauthTokenSecret: ( NSString* )oauthTokenSecret; + ( STTwitterAPI* ) twitterAPIAppOnlyWithConsumerKey: ( NSString* )consumerKey    consumerSecret: ( NSString* )consumerSecret;

上面的代码片段只是用于演示，Objectwitter-C API 是对 Twitter API 的全面封装，所以你可以查阅头文件和 Twitter API 文档来了解任何你想要的东西。