如果 App 需要把內容分享到 QQ 空間、QQ 好友或其他支援的管道,除了常見的第三方分享服務,也可以直接整合騰訊官方提供的 iOS SDK。本文整理從平台申請、專案設定到分享程式碼的完整流程。
先到騰訊開放平台註冊帳號,登入後建立一個 iOS 應用。建立完成會取得 App ID,後續初始化 SDK 與設定 URL Scheme 時都需要使用。即使應用尚未提交審核,也可以先進行開發與測試。
下載 iOS_SDK 後,把 TencentOpenApi_IOS_Bundle.bundle 與 TencentOpenAPI.framework 加入專案。
接著在 Build Phases 的 Link Binary With Libraries 中加入相依函式庫,例如 libz、libstdc++、CoreTelephony、libsqlite3、CoreGraphics、SystemConfiguration、libiconv、Security。
在 Build Settings 的 Linking 區塊,把 Other Linker Flags 設定為 -fobjc-arc。
在 Info 的 URL Types 中新增一個 URL Scheme,命名方式為 tencent 加上你的 App ID。
如果使用 Swift,需要建立橋接標頭,引入 TencentOAuth、QQApiInterface、QQApiInterfaceObject、sdkdef、TencentMessageObject、TencentOAuthObject 等相依標頭。
在 AppDelegate 中,把外部回跳的 URL 交給 TencentOAuth 處理。
func application(_ app: UIApplication, openURL url: URL, options: [UIApplication.OpenURLOptionsKey : Any]) -> Bool {
return TencentOAuth.handleOpenURL(url)
}
若使用舊版 Swift 或舊版 Xcode,也可能需要實作 handleOpenURL 版本。另外,iOS 9 以後預設限制 HTTP 存取,需要在 Info.plist 加入 NSAppTransportSecurity 與 NSAllowsArbitraryLoads。
在發送分享或登入請求前,需要先建立 TencentOAuth 物件,並帶入 App ID。
let tencentOAuth = TencentOAuth(appId: "你的AppID", andDelegate: nil)
當使用者裝置有安裝手機 QQ 時,SDK 會嘗試跳轉到 QQ 完成分享;若沒有安裝,則可能改用瀏覽器或其他替代流程。分享完成後,系統會提示使用者繼續留在 QQ,或返回原本的 App。
let txtObj = QQApiTextObject(text: "分享文字")
let req = SendMessageToQQReq(content: txtObj)
QQApiInterface.sendReq(req)
let imgObj = QQApiImageObject(data: imageData, previewImageData: imageData, title: "圖片標題", description: "圖片描述")
let req = SendMessageToQQReq(content: imgObj)
QQApiInterface.sendReq(req)
let newsObj = QQApiNewsObject(URL: newsUrl, title: title, description: description, previewImageURL: previewImageUrl, targetContentType: QQApiURLTargetTypeNews)
let req = SendMessageToQQReq(content: newsObj)
QQApiInterface.sendReq(req)
let audioObj = QQApiAudioObject(URL: url, title: title, description: description, previewImageURL: previewImageUrl, targetContentType: QQApiURLTargetTypeAudio)
let req = SendMessageToQQReq(content: audioObj)
QQApiInterface.sendReq(req)
let videoObj = QQApiVideoObject(URL: url, title: title, description: description, previewImageURL: previewImageUrl, targetContentType: QQApiURLTargetTypeVideo)
let req = SendMessageToQQReq(content: videoObj)
QQApiInterface.sendReq(req)