tiktok opensdk iosダウンロード - tiktok opensdk iosソースコードのダウンロード

tiktok opensdk ios

その他のソースコード

v2.5.0

ダウンロード

iOS用TikTok OpenSDK

導入

TikTok OpenSDK は、ユーザーが TikTok アカウントを使用してアプリにログインし、画像やビデオを TikTok に共有できるようにするフレームワークです。この SDK は、Swift Package Manager および Cocoapods を通じてダウンロードできます。

はじめる

iOS の最小バージョンは 12.0、XCode の最小バージョンは 10.0 です。詳細については、「iOS クイックスタート」を参照してください。

開発者ポータルアプリケーション

開発者ポータルで開発者アカウントにサインアップします。アプリケーションが承認されると、開発者ポータルからClient KeyとClient Secretが提供されます。アプリの登録方法はこちらをご覧ください。続行する前に、 Manage appsページに移動し、開発者ポータルアカウントで+ Add productsをクリックして、ログインキットや共有キットをアプリに追加してください。

SDKをインストールする

Swiftパッケージマネージャー

ライブラリを Swift パッケージとして XCode プロジェクトに追加します。

File -> Add Packages...クリックします。
リポジトリの URL を貼り付けます: 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 ) を選択します。

カカオポッド

以下を Podfile に追加します

 pod 'TikTokOpenSDKCore'
pod 'TikTokOpenAuthSDK'
pod 'TikTokOpenShareSDK'

pod install --repo-update実行します。

XCode プロジェクトを構成する

Info.plist ファイルを開き、次のキーを追加/更新します。
- 次の値をLSApplicationQueriesSchemesに追加します。
  - ログインキット用のtiktokopensdk
  - シェアキット用のtiktoksharesdk
  - snssdk1233およびsnssdk1180使用して、TikTok がデバイスにインストールされているかどうかを確認します。
- アプリのClient Keyを値としてキーTikTokClientKeyを追加します。
- アプリの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 >

次のコードをアプリの AppDelegate に追加します。

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
    }
    
}

アプリの SceneDelegate ファイルがある場合は、次のコードを追加します。

import TikTokOpenSDKCore

class SceneDelegate : UIResponder , UIWindowSceneDelegate {

    func scene ( _ scene : UIScene , 
               openURLContexts URLContexts : Set < UIOpenURLContext > ) {
        if TikTokURLHandler . handleOpenURL ( URLContexts . first ? . url ) {
            return
        }
    }

}

ログインキットの使用方法

ログインキットの機能はTikTokOpenSDKCoreライブラリとTikTokOpenAuthSDKライブラリに依存するため、パッケージまたは Cocoapod を追加するときに必ずこれらを選択してください。次のコードスニペットは、承認リクエストを作成し、応答を処理する方法を示しています。詳細については、「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ライブラリに依存しているため、パッケージまたは Cocoapod を追加するときに必ずこれらを選択してください。次のコードスニペットは、共有リクエストを作成して応答を処理する方法を示しています。詳細については、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 バージョンは、ShareDemo の場合は iOS 14.0、LoginDemo の場合は iOS 12.0 です。

LoginDemo/TikTokLoginDemo.xcodeprojまたはShareDemo/TikTokShareDemo.xcodeprojを開きます。
物理 iOS デバイスでデモを実行するには、動作するユニバーサルリンクと、関連付けられたドメイン機能を備えたプロビジョニングプロファイルが必要です。プロビジョニングプロファイルをインポートし、バンドル ID を更新し、ユニバーサルリンクドメインを [関連付けられたドメイン] セクションに追加します。 LoginDemo を実行している場合は、開発者ポータルのログインキットセクションのリダイレクト URI 部分にユニバーサルリンクを追加していることを確認してください。
Info.plistファイルをソースコードとして開き、 ${TikTokClientKey}の使用を開発者ポータルの独自のクライアントキーに置き換えます。
プロジェクトを実行して、キットの動作を確認します。