tiktok opensdk ios
v2.5.0
TikTok OpenSDK هو إطار عمل يمكّن المستخدمين من تسجيل الدخول إلى تطبيقك باستخدام حسابات TikTok الخاصة بهم ومشاركة الصور ومقاطع الفيديو على TikTok. يتوفر SDK هذا للتنزيل من خلال Swift Package Manager وCocoapods.
الحد الأدنى لإصدار iOS هو 12.0 والحد الأدنى لإصدار XCode هو 10.0. راجع التشغيل السريع لنظام التشغيل iOS لمزيد من التفاصيل.
قم بالتسجيل للحصول على حساب مطور في بوابة المطور الخاصة بنا. بعد الموافقة على التطبيق، ستزودك بوابة المطور Client Key Client Secret . تعرف على كيفية تسجيل تطبيقك هنا. قبل المتابعة، تأكد من إضافة مجموعة أدوات تسجيل الدخول و/أو مجموعة أدوات المشاركة إلى تطبيقك من خلال الانتقال إلى صفحة Manage apps ، والنقر على + Add products في حساب بوابة المطور الخاص بك.
أضف المكتبة إلى مشروع XCode الخاص بك كحزمة Swift:
File -> Add Packages...https://github.com/tiktok/tiktok-opensdk-iosDependency 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-updateLSApplicationQueriesSchemes :tiktokopensdk لمجموعة تسجيل الدخولtiktoksharesdk لمشاركة المجموعةsnssdk1233 و 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 ، لذا تأكد من تحديدها عند إضافة الحزمة أو الكاكاوبودات. يوضح مقتطف الكود التالي كيفية إنشاء طلب ترخيص والتعامل مع الاستجابة. راجع مجموعة تسجيل الدخول لنظام 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} بمفتاح العميل الخاص بك من بوابة المطور.تم ترخيص كود المصدر هذا بموجب الترخيص الموجود في ملف الترخيص في الدليل الجذر لشجرة المصدر هذه.
