TikTok OpenSDK — это платформа, которая позволяет вашим пользователям входить в ваше приложение со своими учетными записями TikTok и обмениваться изображениями и видео в TikTok. Этот SDK доступен для загрузки через Swift Package Manager и Cocoapods.
Минимальная версия iOS — 12.0, а минимальная версия XCode — 10.0. Дополнительные сведения см. в кратком руководстве по iOS.
Зарегистрируйте учетную запись разработчика на нашем портале разработчиков. После одобрения заявки Портал разработчиков предоставит вам Client Key
и Client Secret
. Узнайте, как зарегистрировать свое приложение здесь. Прежде чем продолжить, обязательно добавьте Login Kit и/или 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
}
}
}
Функциональность Login Kit зависит от библиотек TikTokOpenSDKCore
и TikTokOpenAuthSDK
, поэтому обязательно выбирайте их при добавлении пакета или Cocoapods. В следующем фрагменте кода показано, как создать запрос авторизации и обработать ответ. Дополнительную информацию см. в разделе Login Kit для 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
, поэтому обязательно выбирайте их при добавлении пакета или Cocoapods. В следующем фрагменте кода показано, как создать запрос на общий доступ и обработать ответ. Дополнительные сведения см. в разделе 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 в корневом каталоге этого дерева исходного кода.