TikTok OpenSDK es un marco que permite a sus usuarios iniciar sesión en su aplicación con sus cuentas de TikTok y compartir imágenes y videos en TikTok. Este SDK está disponible para descargar a través de Swift Package Manager y Cocoapods.
La versión mínima de iOS es 12.0 y la versión mínima de XCode es 10.0. Consulte Inicio rápido de iOS para obtener más detalles.
Regístrese para obtener una cuenta de desarrollador en nuestro Portal de desarrolladores. Tras la aprobación de la solicitud, el Portal del desarrollador le proporcionará una Client Key
y Client Secret
. Vea cómo registrar su aplicación aquí. Antes de continuar, asegúrese de agregar el kit de inicio de sesión y/o el kit para compartir a su aplicación navegando a la página Manage apps
y haciendo clic en + Add products
en su cuenta del portal para desarrolladores.
Agregue la biblioteca a su proyecto XCode como un paquete Swift:
File -> Add Packages...
https://github.com/tiktok/tiktok-opensdk-ios
Dependency Rule
-> Up to Next Major Version
e ingrese la versión principal que desee (es decir, 2.3.0
).Add to Project
-> Su proyectoCopy Dependency
y seleccione las bibliotecas que necesita ( TikTokOpenAuthSDK
, TikTokOpenSDKCore
, TikTokOpenShareSDK
). pod 'TikTokOpenSDKCore'
pod 'TikTokOpenAuthSDK'
pod 'TikTokOpenShareSDK'
pod install --repo-update
LSApplicationQueriesSchemes
:tiktokopensdk
para el kit de inicio de sesióntiktoksharesdk
para compartir kitsnssdk1233
y snssdk1180
para comprobar si TikTok está instalado en su dispositivo.TikTokClientKey
con Client Key
de su aplicación como valor.Client Key
de su aplicación a 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 funcionalidad del kit de inicio de sesión depende de las bibliotecas TikTokOpenSDKCore
y TikTokOpenAuthSDK
, así que asegúrese de seleccionarlas al agregar el paquete o cocoapods. El siguiente fragmento de código muestra cómo crear una solicitud de autorización y manejar la respuesta. Consulte el Kit de inicio de sesión para iOS para obtener más detalles.
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 ?? " " ) )
}
}
Su aplicación es responsable de mantener una referencia sólida a la solicitud para poder recibir la devolución de llamada de respuesta. Puede descartarlo cuando haya terminado con la respuesta.
La funcionalidad Share Kit depende de las bibliotecas TikTokOpenSDKCore
y TikTokOpenShareSDK
, así que asegúrese de seleccionarlas al agregar el paquete o cocoapods. El siguiente fragmento de código muestra cómo crear una solicitud para compartir y manejar la respuesta. Consulte Share Kit para iOS para obtener más detalles.
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 ) " )
}
}
Su aplicación es responsable de mantener una referencia sólida a la solicitud para poder recibir la devolución de llamada de respuesta. Puede descartarlo cuando haya terminado con la respuesta.
La versión mínima de iOS para las aplicaciones de demostración es iOS 14.0 para ShareDemo y iOS 12.0 para LoginDemo.
LoginDemo/TikTokLoginDemo.xcodeproj
o ShareDemo/TikTokShareDemo.xcodeproj
.Info.plist
como código fuente y reemplace los usos de ${TikTokClientKey}
con su propia clave de cliente desde el portal de desarrolladores.Este código fuente tiene la licencia que se encuentra en el archivo LICENCIA en el directorio raíz de este árbol fuente.