簡單使用 iOS 5 的 Twitter API

如果您是 iOS 6.0 SDK 以上的使用者，這篇文章你將不再適用，請前往索引式搜索頁面中的 Social 分類項目，取得新的設定方式。

 

從 iOS 5 SDK 開始就內建 Twitter 的 Framework，下面程式碼將介紹如何簡單使用 Twitter API 來實做 Twitter 的推文，其方法與程式碼如下。

既然是使用 Twitter 的 Framework，那首先就要將它加入到我們的專案裡，並且在適當的地方引用其標頭檔，Framework 的加入方式大家可以參考Xcode 4 新增 Framework 的方法一文。

#import <Twitter/Twitter.h>
接著就是實做出推文的程式碼部份。

//建立viewcontroller
TWTweetComposeViewController *twitter = [[TWTweetComposeViewController alloc] init];

//設定推文的內容
[twitter setInitialText:@"iOS 5 Twitter API 測試。"];

//顯示viewcontroller
[self presentModalViewController:twitter animated:YES];

程式碼到此的執行結果就如同文章一開始的示範圖片，已經有了 Twitter 基本的推文功能，這裡值得注意的是，在程式碼中並沒有包含使用者的帳號密碼資訊，因為當你按下 Send 按鍵的同時，系統才會去後台設定尋找你的 Twitter 使用者資訊，若是你已經在裝置上設定好你的 Twitter 使用者資訊，那麼就會使用目前的使用這設定來進行推文。

除了一般的傳統文字外 Twitter API 也支援圖片或是網址超連結等，其方法如下。

//推文中加入圖片資訊
[twitter addImage:[UIImage imageNamed:@"3d logo.png"]];

//推文中加入網址超連結資訊
[twitter addURL:[NSURL URLWithString:[NSString stringWithString:@"http://furnacedigital.blogspot.com/"]]];

另外 Twitter API 也可以針對使用者在按下 Send 或是 Cancel 時分別處理其各自的動作，像是顯示推文成功或是推文失敗等等資訊。

//按下Send或是Cancel時的處理動作(block)
[twitter setCompletionHandler:^(TWTweetComposeViewControllerResult result) {
NSString *output;

switch (result) {
    case TWTweetComposeViewControllerResultCancelled:
         output = @"取消推文";
         break;

    case TWTweetComposeViewControllerResultDone:
         output = @"完成推文";
         break;

    default:
         break;
}

//使用者動作顯示於console
NSLog(@"%@", output);

//移除viewcontroller
[self dismissModalViewControllerAnimated:YES];
}];


有關更多的 Twitter API 使用方法，大家可以參考 iOS Developer Library 的說明。

PS:關於程式碼中所使用的 Block 技巧，可以參閱 Blocks！你不得不學習的 iOS 4 coding 新技術！一文。