TikTok OpenSDK 是一个框架,使您的用户能够使用其 TikTok 帐户登录您的应用程序并将图像和视频共享到 TikTok。该 SDK 可通过 Swift Package Manager 和 Cocoapods 下载。
最低 iOS 版本为 12.0,最低 XCode 版本为 10.0。有关详细信息,请参阅 iOS 快速入门。
在我们的开发者门户中注册开发者帐户。申请批准后,开发者门户将为您提供Client Key
和Client Secret
。请在此处查看如何注册您的应用程序。在继续之前,请确保导航到Manage apps
页面,然后在开发者门户帐户中单击+ Add products
将登录工具包和/或共享工具包添加到您的应用程序。
将库作为 Swift 包添加到您的 XCode 项目中:
File -> Add Packages...
https://github.com/tiktok/tiktok-opensdk-ios
://github.com/tiktok/tiktok-opensdk-iosDependency Rule
-> Up to Next Major Version
并输入您想要的主要版本(即2.3.0
)Add to Project
-> 您的项目Copy Dependency
并选择您需要的库( TikTokOpenAuthSDK
、 TikTokOpenSDKCore
、 TikTokOpenShareSDK
) pod 'TikTokOpenSDKCore'
pod 'TikTokOpenAuthSDK'
pod 'TikTokOpenShareSDK'
pod install --repo-update
LSApplicationQueriesSchemes
:tiktokopensdk
用于登录套件tiktoksharesdk
分享套件snssdk1233
和snssdk1180
检查您的设备上是否安装了 TikTok。TikTokClientKey
并将您的应用程序Client Key
作为值。Client Key
添加到CFBundleURLSchemes
。 < key >LSApplicationQueriesSchemes</ key >
< array >
< string >tiktokopensdk</ string >
< string >tiktoksharesdk</ string >
< string >snssdk1180</ string >
< string >snssdk1233</ string >
</ array >
< key >TikTokClientKey</ key >
< string >$TikTokClientKey</ string >
< key >CFBundleURLTypes</ key >
< array >
< dict >
< key >CFBundleURLSchemes</ key >
< array >
< string >$TikTokClientKey</ string >
</ array >
</ dict >
</ array >
import TikTokOpenSDKCore
@ main
class AppDelegate : UIResponder , UIApplicationDelegate {
func application ( _ app : UIApplication , open url : URL ,
options : [ UIApplication . OpenURLOptionsKey : Any ] = [ : ] ) -> Bool {
if TikTokURLHandler . handleOpenURL ( url ) {
return true
}
return false
}
func application ( _ application : UIApplication ,
continue userActivity : NSUserActivity ,
restorationHandler : @escaping ( [ UIUserActivityRestoring ] ? ) -> Void ) -> Bool {
if userActivity . activityType == NSUserActivityTypeBrowsingWeb {
if TikTokURLHandler . handleOpenURL ( userActivity . webpageURL ) {
return true
}
}
return false
}
}
import TikTokOpenSDKCore
class SceneDelegate : UIResponder , UIWindowSceneDelegate {
func scene ( _ scene : UIScene ,
openURLContexts URLContexts : Set < UIOpenURLContext > ) {
if TikTokURLHandler . handleOpenURL ( URLContexts . first ? . url ) {
return
}
}
}
Login Kit 功能依赖于TikTokOpenSDKCore
和TikTokOpenAuthSDK
库,因此在添加包或 cocoapods 时请务必选择这些库。以下代码片段显示了如何创建授权请求并处理响应。有关更多详细信息,请参阅 iOS 登录套件。
import TikTokOpenAuthSDK
let authRequest = TikTokAuthRequest ( scopes : [ " user.info.basic " ] , redirectURI : " https://www.example.com/path " )
authRequest . send { response in
let authResponse = response as? TikTokAuthResponse else { return }
if authResponse . errorCode == . noError {
print ( " Auth code: ( authResponse . code ) " )
} else {
print ( " Authorization Failed!
Error: ( authResponse . error ?? " " )
Error Description: ( authResponse . errorDescription ?? " " ) )
}
}
您的应用程序负责维护对请求的强引用,以便接收响应回调。完成响应后,您可以将其丢弃。
Share Kit 功能依赖于TikTokOpenSDKCore
和TikTokOpenShareSDK
库,因此在添加包或 cocoapods 时请务必选择这些库。以下代码片段展示了如何创建共享请求并处理响应。有关更多详细信息,请参阅 iOS 共享套件。
import TikTokOpenShareSDK
let shareRequest = TikTokShareRequest ( localIdentifiers : [ ... ] , mediaType : . video , redirectURI : " https://www.example.com/path " )
shareRequest . send { response in
let shareResponse = response as? TikTokShareResponse else { return }
if shareResponse . errorCode == . noError {
print ( " Share succeeded! " )
} else {
print ( " Share Failed!
Error Code: ( shareResponse . errorCode . rawValue )
Error Message: ( shareResponse . errorMessage ?? " " )
Share State: ( shareResponse . shareState ) " )
}
}
您的应用程序负责维护对请求的强引用,以便接收响应回调。完成响应后,您可以将其丢弃。
演示应用程序的最低 iOS 版本是 ShareDemo 的 iOS 14.0 和 LoginDemo 的 iOS 12.0。
LoginDemo/TikTokLoginDemo.xcodeproj
或ShareDemo/TikTokShareDemo.xcodeproj
。Info.plist
文件作为源代码,并将${TikTokClientKey}
的使用替换为开发者门户中您自己的客户端密钥。此源代码根据此源树根目录中的 LICENSE 文件中的许可证获得许可。