iOS SDK 連携
このユーザーガイドでは、ストーリーボードUIにAlli iOS SDKを統合する方法について説明します。 Alli SDKにはiOS 10以降が必要です。
Step1. SDKをダウンロードして解凍します
Alliダッシュボードにログインして、設定メニューに進みます。 下にスクロールしてiOS SDKのダウンロードを見つけ、SDKをダウンロードします。
ファイルを解凍すると、フォルダー内に次のファイルが表示されます。
Step 2. SDKをプロジェクトに追加します
XcodeのProject Navigatorでプロジェクトアイコンを右クリックします。
[アプリにファイルを追加]ボタンをクリックします。 ダイアログが表示されます。
AlliFrameworkフォルダーを選択します。
ダイアログの内容が下記キャプチャーのようになっていることを確認し、[追加]ボタンをクリックします
Step 3. 埋め込みバイナリ、フレームワーク、ライブラリを追加します
Project Navigatorでプロジェクトアイコンをクリックします。
全般 > [フレームワーク、ライブラリ、および埋め込みコンテンツ]に移動し、Alli Framework.frameworkを[署名なしで埋め込み]に設定します。
ビルドフェーズ >[ライブラリとバイナリをリンク]および[埋め込みフレームワーク]を確認します。 AlliFramwork.frameworkが追加されていることを確認してください。
Step 4. Info.plistで権限を指定します
AlliFramework.frameworkフォルダーのinfo.plistファイルを開き、情報プロパティリストの横にある「+」記号をクリックします。 ドロップダウンリストを[プライバシー]オプションまでスクロールし、カメラにアクセスするための[プライバシーカメラ使用法の説明]またはフォトライブラリにアクセスするためのプライバシーフォトライブラリ使用法の説明を選択します。
これにより、ユーザーは領収書ファイルまたは製品画像をチャットにアップロードできます。
選択した後、右側の文字列値を入力して、警告ポップアップが許可を求めたときにユーザーに表示するテキストを含めます。
Step 5. Alli SDKを初期化する
アプリケーションのデリゲートクラスファイルViewController.swiftの先頭に「import AlliFramework」を追加します。 これにより、Alliフレームワークにプロジェクトからアクセスできるようになります。
ViewControllerに以下を追加して、SDKキーでAlliライブラリを初期化します。
※以下の画像には”YOUR_API_Key”と記載がありますが、こちらにSDKキーを記載ください。
AndroidSDK用のJavascripSDKで使用可能なすべてのパラメーターも使用できます。
Dictionary <String、Any>を使用して、JavascriptSDKの初期化に使用されるパラメーターをinitWithParams引数に送信します。
SDKキーは、左側のナビゲーションから[設定]>[全般]をクリックし、プロジェクト設定ページSDKキーを取得してください。
ユーザーとAlliが会話することができるダイアログを作成するには、下記を呼び出します。
Step 6. ダイアログを作成する
特定のユーザIDとPlacementを指定したい場合は以下のように呼び出します。
サービスにログインして、ユーザが特定されている場合、上記のようにAlliに情報を渡すことができます。あるいはログインしていないユーザーのために、一時的なIDを生成することもできます。
Placement情報は、ユーザーにスキルを表示したいアプリ内の場所を決定するために使用されます。Placementを作成した後、Alliダッシュボードで必要なスキルにPlacementを指定することができます。この機能の利点は、プレースメントに表示するスキルをいつでも決定できることです。
Alliダイアログは、親ビューコントローラで実装する必要があります。このとき、親ビューコントローラを委任属性に割り当てる必要があります。この呼び出しに渡されたViewControllerが最上位のビューであり、他のビューに隠れないようにしてください。そして親ビューは、最小の高さと幅が必要です。 initWithParamsと同じように、eventWithParamsを用いることで、すべての使用可能なJavascriptパラメーターが使用できます。
※上記のuserIdの形式にご注意ください。
Step 7. Alliイベントを処理するデリゲートメソッド
次のデリゲートメソッドは、チャットの会話ステータスに関するフィードバックを提供します。
Step 8. 他のアプリとの接続
Alliチャットでhttpまたはhttpsにリンクすると、顧客のデフォルトのブラウザーが起動します。 他のアプリケーションへのリンクを追加する場合は、AlliEventHandlerからhandleUrlLoadingメソッドを実装します。
(例)Apple Mapを起動する場合
最終更新