TikTok OpenSDK adalah kerangka kerja yang memungkinkan pengguna Anda masuk ke aplikasi Anda dengan akun TikTok mereka dan berbagi gambar dan video ke TikTok. SDK ini tersedia untuk diunduh melalui Swift Package Manager dan Cocoapods.
Versi iOS minimum adalah 12.0 dan versi XCode minimum adalah 10.0. Lihat Mulai Cepat iOS untuk detail selengkapnya.
Mendaftarlah untuk akun pengembang di Portal Pengembang kami. Setelah permohonan disetujui, Portal Pengembang akan memberi Anda Client Key
dan Client Secret
. Lihat cara mendaftarkan aplikasi Anda di sini. Sebelum melanjutkan, pastikan untuk menambahkan Kit Login dan/atau Kit Berbagi ke aplikasi Anda dengan membuka halaman Manage apps
, dan mengklik + Add products
di akun portal pengembang Anda.
Tambahkan perpustakaan ke proyek XCode Anda sebagai Paket Swift:
File -> Add Packages...
https://github.com/tiktok/tiktok-opensdk-ios
Dependency Rule
-> Up to Next Major Version
dan masukkan versi utama yang Anda inginkan (yaitu 2.3.0
)Add to Project
-> Proyek AndaCopy Dependency
dan pilih perpustakaan yang Anda perlukan ( TikTokOpenAuthSDK
, TikTokOpenSDKCore
, TikTokOpenShareSDK
) pod 'TikTokOpenSDKCore'
pod 'TikTokOpenAuthSDK'
pod 'TikTokOpenShareSDK'
pod install --repo-update
LSApplicationQueriesSchemes
:tiktokopensdk
untuk Kit Masuktiktoksharesdk
untuk Berbagi Kitsnssdk1233
dan snssdk1180
untuk memeriksa apakah TikTok diinstal pada perangkat Anda.TikTokClientKey
dengan Client Key
aplikasi Anda sebagai nilainya.Client Key
aplikasi Anda ke 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
}
}
}
Fungsionalitas Login Kit bergantung pada pustaka TikTokOpenSDKCore
dan TikTokOpenAuthSDK
, jadi pastikan untuk memilih ini saat menambahkan paket atau kakaopod. Cuplikan kode berikut menunjukkan cara membuat permintaan otorisasi dan menangani responsnya. Lihat Kit Login untuk iOS untuk detail selengkapnya.
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 ?? " " ) )
}
}
Aplikasi Anda bertanggung jawab untuk menjaga referensi yang kuat terhadap permintaan agar dapat menerima callback respons. Anda dapat membuangnya setelah Anda selesai dengan responsnya.
Fungsionalitas Share Kit bergantung pada pustaka TikTokOpenSDKCore
dan TikTokOpenShareSDK
, jadi pastikan untuk memilih keduanya saat menambahkan paket atau kakaopod. Cuplikan kode berikut menunjukkan cara membuat permintaan berbagi dan menangani responsnya. Lihat Share Kit untuk iOS untuk detail selengkapnya.
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 ) " )
}
}
Aplikasi Anda bertanggung jawab untuk menjaga referensi yang kuat terhadap permintaan agar dapat menerima callback respons. Anda dapat membuangnya setelah Anda selesai dengan responsnya.
Versi iOS minimum untuk aplikasi demo adalah iOS 14.0 untuk ShareDemo dan iOS 12.0 untuk LoginDemo.
LoginDemo/TikTokLoginDemo.xcodeproj
atau ShareDemo/TikTokShareDemo.xcodeproj
.Info.plist
sebagai kode sumber dan ganti penggunaan ${TikTokClientKey}
dengan kunci klien Anda sendiri dari portal pengembang.Kode sumber ini dilisensikan berdasarkan lisensi yang ditemukan dalam file LISENSI di direktori akar pohon sumber ini.