TikTok OpenSDK est un framework qui permet à vos utilisateurs de se connecter à votre application avec leurs comptes TikTok et de partager des images et des vidéos sur TikTok. Ce SDK est disponible en téléchargement via Swift Package Manager et Cocoapods.
La version minimale d'iOS est 12.0 et la version minimale de XCode est de 10.0. Consultez le démarrage rapide iOS pour plus de détails.
Créez un compte de développeur sur notre portail de développeur. Une fois la demande approuvée, le portail des développeurs vous fournira une Client Key
et Client Secret
. Découvrez comment enregistrer votre application ici. Avant de continuer, assurez-vous d'ajouter le kit de connexion et/ou le kit de partage à votre application en accédant à la page Manage apps
et en cliquant sur + Add products
dans votre compte de portail de développeur.
Ajoutez la bibliothèque à votre projet XCode en tant que package Swift :
File -> Add Packages...
https://github.com/tiktok/tiktok-opensdk-ios
Dependency Rule
-> Up to Next Major Version
et saisissez la version majeure souhaitée (c'est-à-dire 2.3.0
).Add to Project
-> Votre projetCopy Dependency
et sélectionnez les bibliothèques dont vous avez besoin ( TikTokOpenAuthSDK
, TikTokOpenSDKCore
, TikTokOpenShareSDK
) pod 'TikTokOpenSDKCore'
pod 'TikTokOpenAuthSDK'
pod 'TikTokOpenShareSDK'
pod install --repo-update
LSApplicationQueriesSchemes
:tiktokopensdk
pour le kit de connexiontiktoksharesdk
pour le kit de partagesnssdk1233
et snssdk1180
pour vérifier si TikTok est installé sur votre appareil.TikTokClientKey
avec Client Key
de vos applications comme valeur.Client Key
de vos applications à 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
}
}
}
La fonctionnalité du kit de connexion dépend des bibliothèques TikTokOpenSDKCore
et TikTokOpenAuthSDK
, assurez-vous donc de les sélectionner lors de l'ajout du package ou des cocoapods. L'extrait de code suivant montre comment créer une demande d'autorisation et gérer la réponse. Voir Kit de connexion pour iOS pour plus de détails.
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 ?? " " ) )
}
}
Votre application est chargée de maintenir une référence forte à la demande afin de recevoir le rappel de réponse. Vous pouvez le supprimer lorsque vous avez terminé la réponse.
La fonctionnalité du Share Kit dépend des bibliothèques TikTokOpenSDKCore
et TikTokOpenShareSDK
, assurez-vous donc de les sélectionner lors de l'ajout du package ou des cocoapods. L'extrait de code suivant montre comment créer une demande de partage et gérer la réponse. Voir Kit de partage pour iOS pour plus de détails.
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 ) " )
}
}
Votre application est chargée de maintenir une référence forte à la demande afin de recevoir le rappel de réponse. Vous pouvez le supprimer lorsque vous avez terminé la réponse.
La version iOS minimale pour les applications de démonstration est iOS 14.0 pour ShareDemo et iOS 12.0 pour LoginDemo.
LoginDemo/TikTokLoginDemo.xcodeproj
ou ShareDemo/TikTokShareDemo.xcodeproj
.Info.plist
en tant que code source et remplacez les utilisations de ${TikTokClientKey}
par votre propre clé client depuis le portail des développeurs.Ce code source est sous licence trouvée dans le fichier LICENSE dans le répertoire racine de cette arborescence source.