TikTok OpenSDK เป็นเฟรมเวิร์กที่ช่วยให้ผู้ใช้ของคุณสามารถลงชื่อเข้าใช้แอพของคุณด้วยบัญชี TikTok ของพวกเขา และแชร์รูปภาพและวิดีโอไปยัง TikTok SDK นี้พร้อมให้ดาวน์โหลดผ่าน Swift Package Manager และ Cocoapods
เวอร์ชัน iOS ขั้นต่ำคือ 12.0 และเวอร์ชัน XCode ขั้นต่ำคือ 10.0 ดู iOS QuickStart สำหรับรายละเอียดเพิ่มเติม
ลงทะเบียนบัญชีนักพัฒนาในพอร์ทัลนักพัฒนาของเรา เมื่อได้รับการอนุมัติใบสมัคร พอร์ทัลนักพัฒนาซอฟต์แวร์จะมอบ Client Key
และ Client Secret
ให้กับคุณ ดูวิธีการลงทะเบียนแอปของคุณที่นี่ ก่อนดำเนินการต่อ ตรวจสอบให้แน่ใจว่าได้เพิ่มชุดเข้าสู่ระบบและ/หรือ Share Kit ลงในแอปของคุณโดยไปที่หน้า Manage apps
และคลิก + Add products
ในบัญชีพอร์ทัลนักพัฒนาของคุณ
เพิ่มไลบรารีให้กับโปรเจ็กต์ XCode ของคุณเป็นแพ็คเกจ Swift:
File -> Add Packages...
https://github.com/tiktok/tiktok-opensdk-ios
Dependency Rule
-> Up to Next Major Version
และป้อนเวอร์ชันหลักที่คุณต้องการ (เช่น 2.3.0
)Add to Project
-> โครงการของคุณCopy Dependency
และเลือกไลบรารีที่คุณต้องการ ( TikTokOpenAuthSDK
, TikTokOpenSDKCore
, TikTokOpenShareSDK
) pod 'TikTokOpenSDKCore'
pod 'TikTokOpenAuthSDK'
pod 'TikTokOpenShareSDK'
pod install --repo-update
LSApplicationQueriesSchemes
:tiktokopensdk
สำหรับชุดเข้าสู่ระบบtiktoksharesdk
สำหรับ Share Kitsnssdk1233
และ snssdk1180
เพื่อตรวจสอบว่าติดตั้ง TikTok บนอุปกรณ์ของคุณหรือไม่TikTokClientKey
พร้อมกับ Client Key
ของแอปของคุณเป็นค่าClient Key
แอปของคุณไปที่ 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
}
}
}
ฟังก์ชันการทำงานของชุดการเข้าสู่ระบบขึ้นอยู่กับไลบรารี TikTokOpenSDKCore
และ TikTokOpenAuthSDK
ดังนั้นอย่าลืมเลือกไลบรารีเหล่านี้เมื่อเพิ่มแพ็คเกจหรือ Cocopod ข้อมูลโค้ดต่อไปนี้แสดงวิธีสร้างคำขอการให้สิทธิ์และจัดการการตอบสนอง ดูชุดเข้าสู่ระบบสำหรับ 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 ?? " " ) )
}
}
แอปของคุณมีหน้าที่รับผิดชอบในการรักษาการอ้างอิงที่ชัดเจนไปยังคำขอเพื่อรับการตอบกลับ คุณสามารถละทิ้งได้เมื่อคุณตอบกลับเสร็จแล้ว
ฟังก์ชั่น Share Kit ขึ้นอยู่กับไลบรารี TikTokOpenSDKCore
และ TikTokOpenShareSDK
ดังนั้นอย่าลืมเลือกไลบรารีเหล่านี้เมื่อเพิ่มแพ็คเกจหรือ Cocopod ข้อมูลโค้ดต่อไปนี้แสดงวิธีสร้างคำขอแชร์และจัดการการตอบสนอง ดู Share Kit สำหรับ 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 ) " )
}
}
แอปของคุณมีหน้าที่รับผิดชอบในการรักษาการอ้างอิงที่ชัดเจนไปยังคำขอเพื่อรับการตอบกลับ คุณสามารถละทิ้งได้เมื่อคุณตอบกลับเสร็จแล้ว
เวอร์ชัน iOS ขั้นต่ำสำหรับแอปสาธิตคือ iOS 14.0 สำหรับ ShareDemo และ iOS 12.0 สำหรับ LoginDemo
LoginDemo/TikTokLoginDemo.xcodeproj
หรือ ShareDemo/TikTokShareDemo.xcodeproj
Info.plist
เป็นซอร์สโค้ดและแทนที่การใช้ ${TikTokClientKey}
ด้วยคีย์ไคลเอ็นต์ของคุณเองจากพอร์ทัลนักพัฒนาซอร์สโค้ดนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่พบในไฟล์ LICENSE ในไดเรกทอรีรากของแผนผังต้นทางนี้