TikTok OpenSDK é uma estrutura que permite que seus usuários façam login em seu aplicativo com suas contas TikTok e compartilhem imagens e vídeos no TikTok. Este SDK está disponível para download através do Swift Package Manager e Cocoapods.
A versão mínima do iOS é 12.0 e a versão mínima do XCode é 10.0. Consulte o Início rápido do iOS para obter mais detalhes.
Cadastre-se para obter uma conta de desenvolvedor em nosso Portal do Desenvolvedor. Após a aprovação da inscrição, o Portal do Desenvolvedor fornecerá a você uma Client Key
e Client Secret
. Veja como registrar seu aplicativo aqui. Antes de continuar, certifique-se de adicionar o Login Kit e/ou Share Kit ao seu aplicativo navegando até a página Manage apps
e clicando em + Add products
em sua conta do portal do desenvolvedor.
Adicione a biblioteca ao seu projeto XCode como um pacote Swift:
File -> Add Packages...
https://github.com/tiktok/tiktok-opensdk-ios
Dependency Rule
-> Up to Next Major Version
e insira a versão principal desejada (ou seja, 2.3.0
)Add to Project
-> Seu projetoCopy Dependency
e selecione as bibliotecas necessárias ( TikTokOpenAuthSDK
, TikTokOpenSDKCore
, TikTokOpenShareSDK
) pod 'TikTokOpenSDKCore'
pod 'TikTokOpenAuthSDK'
pod 'TikTokOpenShareSDK'
pod install --repo-update
LSApplicationQueriesSchemes
:tiktokopensdk
para kit de logintiktoksharesdk
para kit de compartilhamentosnssdk1233
e snssdk1180
para verificar se o TikTok está instalado no seu dispositivo.TikTokClientKey
com Client Key
do seu aplicativo como valor.Client Key
do seu aplicativo 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
}
}
}
A funcionalidade do Login Kit depende das bibliotecas TikTokOpenSDKCore
e TikTokOpenAuthSDK
, portanto, certifique-se de selecioná-las ao adicionar o pacote ou cocoapods. O trecho de código a seguir mostra como criar uma solicitação de autorização e lidar com a resposta. Consulte Kit de login para iOS para obter mais detalhes.
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 ?? " " ) )
}
}
Seu aplicativo é responsável por manter uma referência forte à solicitação para receber o retorno de chamada de resposta. Você pode descartá-lo quando terminar a resposta.
A funcionalidade do Share Kit depende das bibliotecas TikTokOpenSDKCore
e TikTokOpenShareSDK
, portanto, certifique-se de selecioná-las ao adicionar o pacote ou cocoapods. O trecho de código a seguir mostra como criar uma solicitação de compartilhamento e lidar com a resposta. Consulte Share Kit para iOS para obter mais detalhes.
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 ) " )
}
}
Seu aplicativo é responsável por manter uma referência forte à solicitação para receber o retorno de chamada de resposta. Você pode descartá-lo quando terminar a resposta.
A versão mínima do iOS para os aplicativos de demonstração é iOS 14.0 para ShareDemo e iOS 12.0 para LoginDemo.
LoginDemo/TikTokLoginDemo.xcodeproj
ou ShareDemo/TikTokShareDemo.xcodeproj
.Info.plist
como código-fonte e substitua os usos de ${TikTokClientKey}
pela sua própria chave do cliente no portal do desenvolvedor.Este código-fonte está licenciado sob a licença encontrada no arquivo LICENSE no diretório raiz desta árvore de origem.