tiktok opensdk ios
v2.5.0
TikTok OpenSDK ist ein Framework, das es Ihren Benutzern ermöglicht, sich mit ihren TikTok-Konten bei Ihrer App anzumelden und Bilder und Videos mit TikTok zu teilen. Dieses SDK kann über Swift Package Manager und Cocoapods heruntergeladen werden.
Die minimale iOS-Version ist 12.0 und die minimale XCode-Version ist 10.0. Weitere Informationen finden Sie im iOS-Schnellstart.
Eröffnen Sie ein Entwicklerkonto in unserem Entwicklerportal. Nach der Antragsgenehmigung stellt Ihnen das Entwicklerportal einen Client Key und Client Secret zur Verfügung. Hier erfahren Sie, wie Sie Ihre App registrieren. Bevor Sie fortfahren, stellen Sie sicher, dass Sie das Login Kit und/oder Share Kit zu Ihrer App hinzufügen, indem Sie zur Seite Manage apps navigieren und in Ihrem Entwicklerportal-Konto + Add products klicken.
Fügen Sie die Bibliothek als Swift-Paket zu Ihrem XCode-Projekt hinzu:
File -> Add Packages...https://github.com/tiktok/tiktok-opensdk-iosDependency Rule -> Up to Next Major Version und geben Sie die gewünschte Hauptversion ein (z. B. 2.3.0 ).Add to Project -> „Ihr Projekt“.Copy Dependency und wählen Sie die benötigten Bibliotheken aus ( TikTokOpenAuthSDK , TikTokOpenSDKCore , TikTokOpenShareSDK ). pod 'TikTokOpenSDKCore'
pod 'TikTokOpenAuthSDK'
pod 'TikTokOpenShareSDK'pod install --repo-update ausLSApplicationQueriesSchemes hinzu:tiktokopensdk für Login Kittiktoksharesdk für Share Kitsnssdk1233 und snssdk1180 um zu überprüfen, ob TikTok auf Ihrem Gerät installiert ist.TikTokClientKey mit Client Key Ihrer App als Wert hinzu.Client Key Ihrer Apps zu CFBundleURLSchemes hinzu. < 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
}
}
} Die Funktionalität des Login-Kits hängt von den Bibliotheken TikTokOpenSDKCore und TikTokOpenAuthSDK ab. Wählen Sie diese daher unbedingt aus, wenn Sie das Paket oder die Cocoapods hinzufügen. Der folgende Codeausschnitt zeigt, wie eine Autorisierungsanforderung erstellt und die Antwort verarbeitet wird. Weitere Informationen finden Sie im Login-Kit für 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 ?? " " ) )
}
}
Ihre App ist dafür verantwortlich, einen starken Verweis auf die Anfrage aufrechtzuerhalten, um den Antwortrückruf zu erhalten. Sie können es verwerfen, wenn Sie mit der Antwort fertig sind.
Die Share Kit-Funktionalität hängt von den Bibliotheken TikTokOpenSDKCore und TikTokOpenShareSDK ab. Wählen Sie diese daher unbedingt aus, wenn Sie das Paket oder die Cocoapods hinzufügen. Der folgende Codeausschnitt zeigt, wie Sie eine Freigabeanforderung erstellen und die Antwort verarbeiten. Weitere Informationen finden Sie unter Share Kit für 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 ) " )
}
}Ihre App ist dafür verantwortlich, einen starken Verweis auf die Anfrage aufrechtzuerhalten, um den Antwortrückruf zu erhalten. Sie können es verwerfen, wenn Sie mit der Antwort fertig sind.
Die minimale iOS-Version für die Demo-Apps ist iOS 14.0 für ShareDemo und iOS 12.0 für LoginDemo.
LoginDemo/TikTokLoginDemo.xcodeproj oder ShareDemo/TikTokShareDemo.xcodeproj .Info.plist als Quellcode und ersetzen Sie die Verwendung von ${TikTokClientKey} durch Ihren eigenen Client-Schlüssel aus dem Entwicklerportal.Dieser Quellcode ist unter der Lizenz lizenziert, die in der LICENSE-Datei im Stammverzeichnis dieses Quellbaums enthalten ist.
