Objectwitter-C dev-0.9.3 释出,增添上传原生视频功能

2015年06月09日 00:14 229 次阅读 来源: 开源中国 作者: 路人甲
摘要 什么是 Objectwitter-CObjectwitter-C 是一款稳定,成熟,全面的 Twitter RESTStreaming API 的 Objective-C 封装,其封装了 Twitter 的全部公开 API。由 @开源中国真理部部长 基于 STTwitter 开发,在 STTwitter 对 Twitter REST API 的全面封装的基础上,增添了很多工具类使得 API 更加抽...

什么是 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 文档来了解任何你想要的东西。


OAuth Consumer Tokens


在 Twitter API 1.1 中,每个客户端应用必须使用consumer key和consumer secret验证自身。你可以在这个 Twitter 站点中为你的 app 申请 consumer tokens:https://dev.twitter.com/apps.

还可以输入136 讨论区:
评 论