Xamarin.iOS の Siri ショートカット

[アーティクル]
08/08/2018

iOS 10 では、Apple が SiriKit を導入したことで、Siri と対話するメッセージング、VoIP 通話、支払い、トレーニング、乗車予約、写真検索アプリを構築できるようになりました。

iOS 11 では、SiriKit はより多くの種類のアプリのサポートを受け、UI カスタマイズの柔軟性が向上しました。

iOS 12 では Siri ショートカットが追加され、すべての種類のアプリで機能を Siri に公開できます。 Siri は、特定のアプリベースのタスクがユーザーに最も関連するタイミングを学習し、この知識を使用して、ショートカットを使用して潜在的なアクションを提案します。ショートカットをタップするか、音声コマンドで呼び出すと、アプリが開くか、バックグラウンドタスクが実行されます。

ショートカットは、ユーザーが共通のタスクを実行する機能を促進する目的で使用されるべきです。多くの場合、対象のアプリを開く必要すらなく実行できます。

サンプルアプリ: Soup Chef

Siri ショートカットについて理解を深めるために、Soup Chef サンプルアプリを見てみましょう。 Soup Chef を使用すると、ユーザーは架空のスープレストランからの注文を行い、注文履歴を表示し、Siri と対話してスープを注文するときに使用するフレーズを定義できます。

ヒント

iOS 12 シミュレーターまたはデバイスで Soup Chef をテストする前に、次の 2 つの設定を有効にします。これは、ショートカットをデバッグするときに役立ちます。

[設定] アプリで、[開発] >[最近使ったショートカットを表示する] を有効にします。
[設定] アプリで、[開発者] > [ロック画面に寄付を表示する] を有効にします。

これらのデバッグ設定を使用すると、iOS のロック画面と検索画面で、最近作成された (予測される代わりに) ショートカットを簡単に見つけることができます。

サンプルアプリを使用するには:

iOS 12 シミュレーターまたはデバイスに、Soup Chef サンプルアプリをインストールして実行します。
右上隅にある + ボタンをクリックして、新しい注文を作成します。
スープの種類を選択し、数量とオプションを指定して、[注文する] をタップします。
[注文履歴] 画面で、新しく作成した注文をタップして詳細を表示します。
注文の詳細画面の下部にある [Siri に追加] をタップします。
音声フレーズを録音して注文に関連付け、[完了] をタップします。
Soup Chef を最小化し、Siri を呼び出し、録音した音声フレーズを使用して注文を再度行います。
Siri が注文を完了したら、Soup Chef をもう一度開き、[注文履歴] 画面に新しい注文が表示されていることを確認します。

このサンプルアプリでは、次を示します。

NSUserActivity ショートカットを使用してアプリを開きます。
カスタム意図ショートカットを使用してタスクを実行します。
カスタム意図のユーザーインターフェイスを指定します。
音声ショートカットを作成します。

Info.plist と Entitlements.plist

Soup Chef コードをさらに詳しく調べる前に、Info.plist ファイルと Entitlements.plist ファイルを見てみましょう。

Info.plist

SoupChef プロジェクトの Info.plist ファイルは、バンドル識別子を com.xamarin.SoupChef として定義します。このバンドル識別子は、このドキュメントで後述する Intents と Intents UI の拡張機能のバンドル識別子のプレフィックスとして使用されます。

Info.plist ファイルには、次のエントリも含まれています。

<key>NSUserActivityTypes</key>
<array>
    <string>OrderSoupIntent</string>
    <string>com.xamarin.SoupChef.viewMenu</string>
</array>

この NSUserActivityTypes キーと値のペアは、Soup Chef が、OrderSoupIntent と "com.xamarin.SoupChef.viewMenu" の ActivityType を持つ NSUserActivity の処理方法を認識していることを示します。

アプリ自体に渡されるアクティビティとカスタム意図は、拡張機能とは対照的に、AppDelegate (ContinueUserActivity メソッドによる UIApplicationDelegate) で処理されます。

Entitlements.plist

SoupChef プロジェクトの Entitlements.plist ファイルには、次のエントリが含まれています。

<key>com.apple.security.application-groups</key>
<array>
    <string>group.com.xamarin.SoupChef</string>
</array>
<key>com.apple.developer.siri</key>
<true/>

この構成は、アプリが "group.com.xamarin.SoupChef" アプリグループを使用していることを示します。 SoupChefIntents アプリ拡張機能では、この同じアプリグループを使用します。これにより、2 つのプロジェクトを共有できます。NSUserDefaults データ。

com.apple.developer.siri キーは、アプリが Siri と対話することを示します。

Note

SoupChef プロジェクトのビルド構成では、カスタムエンタイトルメントが Entitlements.plist に設定されます。

NSUserActivity ショートカットを使用してアプリを開く

アプリを開いて特定のコンテンツを表示するショートカットを作成するには、NSUserActivity を作成し、ショートカットを開く画面のビューコントローラーにアタッチします。

NSUserActivity の設定

メニュー画面で、SoupMenuViewController は NSUserActivity を作成し、ビューコントローラーの UserActivity プロパティに割り当てます。

public override void ViewDidLoad()
{
    base.ViewDidLoad();
    UserActivity = NSUserActivityHelper.ViewMenuActivity;
}

UserActivity プロパティを設定すると、アクティビティが Siri に寄付されます。この寄付から、Siri は、このアクティビティがユーザーに関連するタイミングと場所に関する情報を取得し、将来より適切に提案することを学習します。

NSUserActivityHelper は、SoupKit クラスライブラリ内の SoupChef ソリューションに含まれるユーティリティクラスです。 NSUserActivity を作成し、Siri に関連するさまざまなプロパティを設定して検索します。

public static string ViewMenuActivityType = "com.xamarin.SoupChef.viewMenu";

public static NSUserActivity ViewMenuActivity {
    get
    {
        var userActivity = new NSUserActivity(ViewMenuActivityType)
        {
            Title = NSBundleHelper.SoupKitBundle.GetLocalizedString("ORDER_LUNCH_TITLE", "View menu activity title"),
            EligibleForSearch = true,
            EligibleForPrediction = true
        };

        var attributes = new CSSearchableItemAttributeSet(NSUserActivityHelper.SearchableItemContentType)
        {
            ThumbnailData = UIImage.FromBundle("tomato").AsPNG(),
            Keywords = ViewMenuSearchableKeywords,
            DisplayName = NSBundleHelper.SoupKitBundle.GetLocalizedString("ORDER_LUNCH_TITLE", "View menu activity title"),
            ContentDescription = NSBundleHelper.SoupKitBundle.GetLocalizedString("VIEW_MENU_CONTENT_DESCRIPTION", "View menu content description")
        };
        userActivity.ContentAttributeSet = attributes;

        var phrase = NSBundleHelper.SoupKitBundle.GetLocalizedString("ORDER_LUNCH_SUGGESTED_PHRASE", "Voice shortcut suggested phrase");
        userActivity.SuggestedInvocationPhrase = phrase;
        return userActivity;
    }
}

特に、次の機能に注意してください。

EligibleForPrediction を true に設定すると、Siri がこのアクティビティを予測し、ショートカットとして表示できることを示します。
ContentAttributeSet 配列は、iOS の検索結果に NSUserActivity を含めるために使用される標準的な CSSearchableItemAttributeSet です。
SuggestedInvocationPhrase は、ショートカットにフレーズを割り当てるときに、Siri が潜在的な選択肢としてユーザーに提案するフレーズです。

NSUserActivity ショートカットの処理

ユーザーによって呼び出された NSUserActivity ショートカットを処理するため、iOS アプリケーションは、渡された NSUserActivity オブジェクトの ActivityType フィールドに基づいて応答して、AppDelegate クラスの ContinueUserActivity メソッドをオーバーライドする必要があります。

public override bool ContinueUserActivity(UIApplication application, NSUserActivity userActivity, UIApplicationRestorationHandler completionHandler)
{
    // ...
    else if (userActivity.ActivityType == NSUserActivityHelper.ViewMenuActivityType)
    {
        HandleUserActivity();
        return true;
    }
    // ...
}

このメソッドは HandleUserActivity を呼び出し、ここでメニュー画面にセグエを検索して呼び出します。

void HandleUserActivity()
{
    var rootViewController = Window?.RootViewController as UINavigationController;
    var orderHistoryViewController = rootViewController?.ViewControllers?.FirstOrDefault() as OrderHistoryTableViewController;
    if (orderHistoryViewController is null)
    {
        Console.WriteLine("Failed to access OrderHistoryTableViewController.");
        return;
    }
    var segue = OrderHistoryTableViewController.SegueIdentifiers.SoupMenu;
    orderHistoryViewController.PerformSegue(segue, null);
}

NSUserActivity へのフレーズの割り当て

NSUserActivity にフレーズを割り当てるには、iOS の [設定] アプリを開き、[Siri/Search] > [ショートカット] を選択します。次に、ショートカット (この場合は "Order Lunch") を選択し、フレーズを記録します。

Siri を呼び出してこのフレーズを使用すると、メニュー画面に Soup Chef が開きます。

カスタム意図ショートカットを使用したタスクの実行

カスタム意図の定義

ユーザーがアプリに関連する特定のタスクをすばやく完了できるようにするショートカットを提供するには、カスタム意図を作成します。カスタム意図は、ユーザーが完了したいタスク、そのタスクに関連するパラメーター、およびタスクの実行に起因する潜在的な応答を表します。カスタム意図の定義方法に応じて、それを呼び出すと、アプリを開くか、バックグラウンドタスクを実行できます。

Xcode 10 を使用してカスタム意図を作成します。 SoupChef リポジトリでは、OrderSoupIntentCodeGen (Objective-C プロジェクト) でカスタム意図が定義されます。このプロジェクトを開き、プロジェクトナビゲーターで Intents.intentdefinition ファイルを選択して、OrderSoup 意図を表示します。

次の機能に注意してください。

この意図には、Order の Category が含まれています。カスタム意図に使用できる定義済みのカテゴリはさまざまです。自分のカスタム意図が有効にするタスクに最もよく一致するものを選びます。このソリューションはスープ注文アプリであるため、OrderSoupIntent は Order を使用します。
[確認] チェックボックスは、タスクを実行する前に、Siri が確認を要求する必要があるかどうかを示します。 Soup Chef の Order Soup 意図では、ユーザーが購入を行うため、このオプションが有効になります。
.intentdefinition ファイルの Parameters セクションで、ショートカットに関連するパラメータを定義します。スープを注文するには、スープの種類、量、および関連するオプションを Soup Chef が認識できる必要があります。各パラメータには型があります。定義済みの型で表すことができないパラメータは Custom として設定されます。
ショートカットの種類インターフェイスでは、ショートカットを提案するときに Siri が使用できるさまざまなパラメータの組み合わせについて説明します。関連する Title セクションと Subtitle セクションを使用すると、ユーザーに推奨されるショートカットを提示するときに Siri が使用するメッセージを定義できます。
[バックグラウンド実行をサポートします] チェックボックスは、ユーザーの操作を強化するために、アプリを開かずに実行できるショートカットに対して選択する必要があります。

カスタム意図の応答の定義

OrderSoup 意図の下に入れ子になった Response 項目は、スープ注文の結果として生じる可能性のある応答を表します。

OrderSoup 意図の応答定義で、次の機能に注目してください。

応答の Properties を使用して、ユーザーに返すメッセージをカスタマイズできます。 OrderSoup 意図の応答には、soup プロパティと waitTime プロパティがあります。
応答テンプレートは、意図のタスクが完了した後の状態を示すために使用できるさまざまな成功メッセージと失敗メッセージを指定します。
成功を示す応答の [成功] チェックボックスをオンにする必要があります。
OrderSoupIntent 成功応答では、soup プロパティと waitTime プロパティを使用して、スープの注文の準備が整うタイミングを説明するわかりやすい便利なメッセージを提供します。

カスタム意図のコードの生成

このカスタム意図定義を含む Xcode プロジェクトをビルドすると、Xcode は、カスタム意図とその応答とプログラムで対話するために使用できるコードを生成します。

この生成されたコードを表示するには、次の手順を実行します。

AppDelegate.m を開きます。
カスタム意図のヘッダーファイルにインポートを追加します: #import "OrderSoupIntent.h"
クラス内の任意のメソッドで、OrderSoupIntent への参照を追加します。
OrderSoupIntent を右クリックし、[定義へ移動] を選択します。
新しく開いたファイル OrderSoupIntent.h を右クリックし、[Show in Finder] を選択します。
この操作により、.h を含む Finder ウィンドウと、生成されたコードを含む .m ファイルが開きます。

この生成されたコードには、次のものが含まれます。

OrderSoupIntent - カスタム意図を表すクラス。
OrderSoupIntentHandling - 意図を実行する必要があることを確認するために使用されるメソッドを定義するプロトコルと、それを実際に実行するメソッド。
OrderSoupIntentResponseCode - さまざまな応答状態を定義する列挙型。
OrderSoupIntentResponse - 意図の実行に対する応答を表すクラス。

カスタム意図へのバインドの作成

Xamarin.iOS アプリで Xcode によって生成されたコードを使用するには、その C# バインドを作成します。

スタティックライブラリと C# バインド定義の作成

SoupChef リポジトリで、OrderSoupIntentStaticLib フォルダーを確認し、OrderSoupIntentStaticLib.xcodeproj Xcode プロジェクトを開きます。

この Cocoa Touch スタティックライブラリ プロジェクトには、Xcode によって生成された OrderSoupIntent.h ファイルと OrderSoupIntent.m ファイルが含まれています。

スタティックライブラリプロジェクトのビルド設定の構成

Xcode プロジェクトナビゲーターで、最上位のプロジェクト OrderSoupIntentStaticLib を選択し、[ビルドフェーズ] > [コンパイルソース] に移動します。 OrderSoupIntent.m (OrderSoupIntent.h をインポート) がここに一覧表示されていることに注意してください。 [バイナリとライブラリをリンク] に、Intents.framework と Foundation.framework が含まれていることに注意してください。これらの設定を適切に設定すると、フレームワークが正しくビルドされます。

スタティックライブラリのビルドと C# バインド定義の生成

スタティックライブラリをビルドし、それに対して C# バインド定義を生成するには、次の手順に従います。

[Objective Sharpie をインストールする] は、Xcode によって作成された .h ファイルおよび .m ファイルからバインド定義を生成するために使用されるツールです。
Xcode 10 コマンドラインツールを使用するように、システムを構成します。

警告

選択したコマンドラインツールを更新すると、システムにインストールされているすべてのバージョンの Xcode に影響します。 Soup Chef サンプルアプリの使用が完了したら、この設定を元の構成に戻してください。
- Xcode で、[Xcode] >[基本設定] > [場所] を選択し、システムで利用可能な最新の Xcode 10 にコマンドラインツールをインストールに設定します。
ターミナルで、cd を OrderSoupIntentStaticLib ディレクトリに実行します。
型 make は、次をビルドします。
- スタティックライブラリ libOrderSoupIntentStaticLib.a
- bo 出力ディレクトリで、C# バインドの定義は次のようになります。
  - ApiDefinitions.cs
  - StructsAndEnums.cs

この静的ライブラリとそれに関連付けられているバインド定義に依存する OrderSoupIntentBindings プロジェクトは、これらの項目を自動的にビルドします。ただし、上記のプロセスを手動で実行すると、想定どおりにビルドされます。

スタティックライブラリの作成と Objective Sharpie を使用した C# バインド定義の作成の詳細については、「チュートリアル - iOS Objective-Cライブラリのバインド」をご覧ください。

バインドライブラリの作成

スタティックライブラリと C# バインド定義が作成されたので、Xamarin.iOS プロジェクトで Xcode で生成された意図関連コードを使用するために必要な残りの部分は、バインドライブラリです。

Soup Chef リポジトリで、SoupChef.sln ファイルを開きます。特に、このソリューションには、OrderSoupIntentBinding (前に生成されたスタティックライブラリへのバインドライブラリ) が含まれています。

特に、このプロジェクトには次のものが含まれていることに注意してください。

ApiDefinitions.cs - 前に Objective Sharpie によって生成され、このプロジェクトに追加されたファイル。このファイルのビルドアクションは、ObjcBindingApiDefinition に設定されます。
StructsAndEnums.cs - 前に Objective Sharpie によって生成され、このプロジェクトに追加された別のファイル。このファイルのビルドアクションは、ObjcBindingCoreSource に設定されます。
先ほどビルドしたスタティックライブラリである libOrderSoupIntentStaticLib.a へのネイティブ参照。ネイティブ参照プロパティを更新し、次の値を指定します。
1. フレームワーク = Foundation Intents
2. スマートリンク = On
3. 強制読み込み = On
4. 種類 = Static

Note

ApiDefinitions.cs と StructsAndEnums.cs の両方に、[Watch (5,0), iOS (12,0)] などの属性が含まれています。 Objective Sharpie によって生成されたこれらの属性は、このプロジェクトには必要ないため、コメントアウトされています。

C# バインドライブラリの作成の詳細については、「チュートリアル - iOS Objective-C ライブラリのバインド」をご覧ください。

SoupChef プロジェクトには、OrderSoupIntentBinding への参照が含まれていることに注意してください。つまり、C# で、含まれるクラス、インターフェイス、列挙型にアクセスできるようになりました。

OrderSoupIntent
OrderSoupIntentHandling
OrderSoupIntentResponse
OrderSoupIntenseResponseCode

Swift フレームワークの作成

意図定義のネイティブコードは、既定でネイティブプロジェクトの言語を使用して Xcode によって生成されます。 Swift プロジェクトで Intents.intentdefinition ファイルを定義すると、Xcode によって、必要なすべてのクラスを含む 1 つの Swift ファイルが生成されます。このファイルを使用して Swift フレームワークを作成できます。

ヒント

Xcode ビルド設定で、生成された意図コードに必要な言語を選択できます。 [Intent target]\(意図ターゲット\) > [ビルド設定] > [Intent Definition Compiler - Code Generation]\(意図定義コンパイラー - コードの生成\) に移動し、Swift または Objective-C を選択します。また、ターゲット言語に合わせて自動で保持することもできます。

Swift フレームワークを作成するプロセスは、前に説明したプロセスと似ています。

新しい Swift フレームワークプロジェクトを作成します。
自動的に生成された Swift ファイルと意図コードをこのプロジェクトにコピーします。このファイルは、ここの説明に従って見つけることができます。
Objective-Cブリッジヘッダーを有効にして、Objective-C sharpie ヘッダーファイルに必要なフレームワークが自動的に生成されるようにします。

フレームワークがビルドされたら、前述の同じ手順に従って Xamarin バインドを作成します。 Swift フレームワークのバインドの作成の詳細については、ここをご覧ください。

ソリューションへの意図定義ファイルの追加

C# SoupChef ソリューションでは、SoupKit プロジェクトに、アプリとその拡張機能の間で共有されるコードが含まれています。 Intents.intentdefinition ファイルは、SoupKit の Base.lproj ディレクトリに配置されており、コンテンツのビルドアクションがあります。ビルドプロセスでは、このファイルが Soup Chef アプリバンドルにコピーされます。このバンドルは、アプリが正しく機能するために必要です。

意図の寄付

Siri がショートカットを提案するには、まずショートカットが関連するタイミングを理解する必要があります。

Siri にこの理解を与えるために、Soup Chef は、ユーザーがスープを注文するたびに、Siri に意図を寄付します。この寄付 (寄付されたとき、寄付された場所、含まれているパラメータ) に基づいて、Siri は、将来のショートカットを提案するタイミングを学びます。

SoupChef は SoupOrderDataManager クラスを使用して寄付を行います。ユーザーのスープ注文を行うために呼び出されると、次に PlaceOrder メソッドは DonateInteraction を呼び出します。

void DonateInteraction(Order order)
{
    var interaction = new INInteraction(order.Intent, null);
    interaction.Identifier = order.Identifier.ToString();
    interaction.DonateInteraction((error) =>
    {
        // ...
    });
}

意図をフェッチすると、意図は INInteraction にラップされます。 INInteraction に Identifier が与えられます。これは、注文の一意の ID と照合されます (後で無効になった意図の寄付を削除するときに役立ちます)。その後、この対話は Siri に寄付されます。

order.Intent ゲッターの呼び出が、注文を表す OrderSoupIntent をフェッチします。これには、その Quantity、Soup、Options、イメージ、Siri が意図に関連付けるためのフレーズをユーザーが記録するときに候補として使用する呼び出しフレーズが設定されています。

public OrderSoupIntent Intent
{
    get
    {
        var orderSoupIntent = new OrderSoupIntent();
        orderSoupIntent.Quantity = new NSNumber(Quantity);
        orderSoupIntent.Soup = new INObject(MenuItem.ItemNameKey, MenuItem.LocalizedString);

        var image = UIImage.FromBundle(MenuItem.IconImageName);
        if (!(image is null))
        {
            var data = image.AsPNG();
            orderSoupIntent.SetImage(INImage.FromData(data), "soup");
        }

        orderSoupIntent.Options = MenuItemOptions
            .ToArray<MenuItemOption>()
            .Select<MenuItemOption, INObject>(arg => new INObject(arg.Value, arg.LocalizedString))
            .ToArray<INObject>();

        var comment = "Suggested phrase for ordering a specific soup";
        var phrase = NSBundleHelper.SoupKitBundle.GetLocalizedString("ORDER_SOUP_SUGGESTED_PHRASE", comment);
        orderSoupIntent.SuggestedInvocationPhrase = String.Format(phrase, MenuItem.LocalizedString);

        return orderSoupIntent;
    }
}

無効な寄付の削除

Siri が役に立たない、または混乱を招くショートカットの提案をしないように、無効になった寄付は削除するのが重要です。

Soup Chef では、[メニューの構成] 画面を使用して、メニュー品目を使用不可としてマークできます。 Siri は、使用できないメニュー品目を注文するショートカットを提案すべきでないため、SoupMenuManager の RemoveDonation メソッドは、使用できなくなったメニュー品目の寄付を削除します。アプリは、次の方法でこの機能を実装します。

現在使用できないメニュー品目に関連付けられている注文を検索します。
識別子を取得します。
同じ識別子を持つ操作を削除します。

void RemoveDonation(MenuItem menuItem)
{
    if (!menuItem.IsAvailable)
    {
        Order[] orderHistory = OrderManager?.OrderHistory.ToArray<Order>();
        if (orderHistory is null)
        {
            return;
        }

        string[] orderIdentifiersToRemove = orderHistory
            .Where<Order>((order) => order.MenuItem.ItemNameKey == menuItem.ItemNameKey)
            .Select<Order, string>((order) => order.Identifier.ToString())
            .ToArray<string>();

        INInteraction.DeleteInteractions(orderIdentifiersToRemove, (error) =>
        {
            if (!(error is null))
            {
                Console.WriteLine($"Failed to delete interactions with error {error.ToString()}");
            }
            else
            {
                Console.WriteLine("Successfully deleted interactions");
            }
        });
    }
}

寄付の成功の検証

ソリューションには、複数のプロジェクトと特定の構成が含まれています。場合によっては、構成が不完全なためにアプリケーションがクラッシュする可能性があります。また、対話を警告なしに寄付できないこともあります。寄付が成功したことを検証するのが重要であり、iOS 開発者設定がそれに役立ちます。 [設定] > [開発者] に移動し、次の開発者オプションを有効にして、最近の寄付とショートカットを表示します。

最近使ったショートカットを表示する
ロック画面に寄付を表示する

有効にすると、成功したすべての寄付がロック画面と Siri の提案オプションの下に表示されます。アプリケーションの実行後に寄付が表示されない場合は、次のトラブルシューティングケースを確認してください。

アプリが次のエラーで OrderSoupIntent を作成できません。

型 'NativeLibrary.OrderSoupIntent' のネイティブインスタンスを作成できませんでした: ネイティブクラスが読み込まれていません。

このエラーは、Xamarin が Xamarin バインドを介してネイティブクラスを読み込めないことを意味します。これを修正するには、ネイティブライブラリに必要なコードが含まれていることを確認し、バインドプロジェクトによって参照され、適切なフラグが設定されていることを確認します。ここで説明されているように、Force Load フラグを On に設定します。
アプリは、次のエラーで意図クラスの読み込まれたネイティブインスタンスを初期化できません。

型 'NativeLibrary.OrderSoupIntent' のインスタンスを初期化できませんでした: ネイティブ 'init' メソッドが nil を返しました。

この問題は、不足している意図定義ファイルに関連しています。 Xamarin アプリには、ここで説明されているように、Content 型の元の意図定義ファイルを含める必要があります。
アプリは意図を作成し、クラッシュせずに寄付メソッドを呼び出しますが、コンソール出力には不明な意図の種類に関する警告が表示され、寄付は行われません。

有効なショートカットの種類がない OrderSoupIntent との対話を寄付できません

この問題を解決するには、plist で意図が適切に定義されており、Siri のエンタイトルメントを有効にし、プロジェクト設定を使用して現在のビルド構成に対して選択する必要があります。

アプリの info.plist は次のとおりです。
```
<key>NSUserActivityTypes</key>
<array>
    <string>ScheduleMeetingIntent</string>
</array>
```
Siri 機能を備えたアプリの Entitlements.plist は次のとおりです。
```
<key>com.apple.developer.siri</key>
<true/>
```
対象のビルド構成に対してカスタムエンタイトルメントを選択する必要があります。 [プロジェクト設定] >[ビルド] > [iOS バンドル署名] に移動し、[カスタムエンタイトルメント] を必要なエンタイトルメントを含む Entitlements.plist ファイルに設定します。

Intents の拡張機能の作成

Siri が意図を呼び出すときに実行されるコードは Intents の拡張機能に配置されます。これは、新しいプロジェクトとして、Soup Chef などの既存の Xamarin.iOS アプリと同じソリューションに追加できます。 SoupChef ソリューションでは、拡張機能は SoupChefIntents と呼ばれます。

SoupChefIntents - Info.plist と Entitlements.plist

SoupChefIntents - Info.plist

SoupChefIntents プロジェクトの Info.plist では、バンドル識別子が com.xamarin.SoupChef.SoupChefIntents として定義されます。

Info.plist ファイルには、次のエントリも含まれています。

<key>NSExtension</key>
<dict>
    <key>NSExtensionAttributes</key>
    <dict>
        <key>IntentsRestrictedWhileLocked</key>
        <array/>
        <key>IntentsSupported</key>
        <array>
            <string>OrderSoupIntent</string>
        </array>
        <key>IntentsRestrictedWhileProtectedDataUnavailable</key>
        <array/>
    </dict>
    <key>NSExtensionPointIdentifier</key>
    <string>com.apple.intents-service</string>
    <key>NSExtensionPrincipalClass</key>
    <string>IntentHandler</string>
</dict>

上記の Info.plist は次のとおりです。

IntentsRestrictedWhileLocked に、デバイスのロックが解除されたときに処理される意図が一覧表示されます。
IntentsSupported に、この拡張機能によって処理される意図が一覧表示されます。
NSExtensionPointIdentifier は、アプリ拡張機能の種類を指定します。詳細については、Apple のドキュメントをご覧ください。
NSExtensionPrincipalClass は、この拡張機能でサポートされている意図を処理するために使用するクラスを指定します。

SoupChefIntents - Entitlements.plist

SoupChefIntents プロジェクトの Entitlements.plist には、アプリグループ機能があります。この機能は、SoupChef プロジェクトと同じアプリグループを使用するように構成されています。

<key>com.apple.security.application-groups</key>
<array>
    <string>group.com.xamarin.SoupChef</string>
</array>

NSUserDefaultsSoup Chef でデータが保持されます。アプリとアプリ拡張機能の間でデータを共有するために、Entitlements.plist ファイル内の同じアプリグループを参照します。

Note

SoupChefIntents プロジェクトのビルド構成では、カスタムエンタイトルメントが Entitlements.plist に設定されます。

OrderSoupIntent バックグラウンドタスクの処理

Intents の拡張機能は、カスタム意図に基づいてショートカットに必要なバックグラウンドタスクを実行します。

Siri は、IntentHandler クラス (Info.plist で NSExtensionPrincipalClass として定義されている) GetHandler メソッドを呼び出し、OrderSoupIntentHandling を拡張するクラスのインスタンスを取得します。これは、OrderSoupIntent を処理するために使用できます。

[Register("IntentHandler")]
public class IntentHandler : INExtension
{
    public override NSObject GetHandler(INIntent intent)
    {
        if (intent is OrderSoupIntent)
        {
            return new OrderSoupIntentHandler();
        }
        throw new Exception("Unhandled intent type: ${intent}");
    }

    protected IntentHandler(IntPtr handle) : base(handle) { }
}

共有コードの SoupKit プロジェクトで定義された OrderSoupIntentHandler は、次の 2 つの重要なメソッドを実装します。

ConfirmOrderSoup - 意図に関連付けられているタスクを実際に実行する必要があるかどうかを確認します
HandleOrderSoup - スープの注文を行い、渡された完了ハンドラーを呼び出してユーザーに応答します。

アプリを開く OrderSoupIntent の処理

アプリは、バックグラウンドで実行されない意図を適切に処理する必要があります。これらの意図は、NSUserActivity ショートカットと同じ方法で、AppDelegate の ContinueUserActivity メソッドで処理されます。

public override bool ContinueUserActivity(UIApplication application, NSUserActivity userActivity, UIApplicationRestorationHandler completionHandler)
{
    var intent = userActivity.GetInteraction()?.Intent as OrderSoupIntent;
    if (!(intent is null))
    {
        HandleIntent(intent);
        return true;
    }
    // ...
}

カスタム意図のユーザーインターフェイスの提供

Intents UI の拡張機能は、Intents の拡張機能のカスタムユーザーインターフェイスを提供します。 SoupChef ソリューションでは、SoupChefIntentsUI は、SoupChefIntents のインターフェイスを提供する Intents UI の拡張機能です。

SoupChefIntentsUI - Info.plist と Entitlements.plist

SoupChefIntentsUI - Info.plist

SoupChefIntentsUI プロジェクトの Info.plist では、バンドル識別子が com.xamarin.SoupChef.SoupChefIntentsui として定義されます。

Info.plist ファイルには、次のエントリも含まれています。

<key>NSExtension</key>
<dict>
    <key>NSExtensionAttributes</key>
    <dict>
        <key>IntentsSupported</key>
        <array>
            <string>OrderSoupIntent</string>
        </array>
        <!-- ... -->
    </dict>
    <key>NSExtensionPointIdentifier</key>
    <string>com.apple.intents-ui-service</string>
    <key>NSExtensionMainStoryboard</key>
    <string>MainInterface</string>
</dict>

上記の Info.plist は次のとおりです。

IntentsSupported は、OrderSoupIntent が、この Intents UI の拡張機能によって処理されることを示します。
NSExtensionPointIdentifier は、アプリ拡張機能の種類を指定します。詳細については、Apple のドキュメントをご覧ください。
NSExtensionMainStoryboard は、この拡張機能のプライマリインターフェイスを定義するストーリーボードを指定します

SoupChefIntentsUI - Entitlements.plist

SoupChefIntentsUI プロジェクトには Entitlements.plist ファイルは必要ありません。

ユーザーインターフェイスの作成

SoupChefIntentsUI の Info.plist は NSExtensionMainStoryboard キーを MainInterface に設定するため、MainInterace.storyboard ファイルは Intents UI の拡張機能のインターフェイスを定義します。

このストーリーボードには、IntentViewController 型の単一のビューコントローラーがあります。次の 2 つのビューを参照します。

InvoiceView 型の invoiceView
ConfirmOrderView 型の confirmationView

Note

invoiceView と confirmationView の各インターフェイスは、セカンダリビューとして、Main.storyboard で定義されています。 Visual Studio for Mac と Visual Studio 2017 では、セカンダリビューの表示または編集はサポートされていません。これを行うには、Xcode の Interface Builder で Main.storyboard を開きます。

IntentViewController が実装する IINUIHostedViewControlling インターフェイス。Siri の意図を操作するときにカスタムインターフェイスを提供するために使用されます。 .ConfigureView メソッドが、このインターフェイスをカスタマイズするために呼び出され、対話が確認されたか (INIntentHandlingStatus.Ready) 正常に実行されたか (INIntentHandlingStatus.Success) に応じて、確認または請求書が表示されます。

[Export("configureViewForParameters:ofInteraction:interactiveBehavior:context:completion:")]
public void ConfigureView(
    NSSet<INParameter> parameters,
    INInteraction interaction,
    INUIInteractiveBehavior interactiveBehavior,
    INUIHostedViewContext context,
    INUIHostedViewControllingConfigureViewHandler completion)
{
    // ...
    if (interaction.IntentHandlingStatus == INIntentHandlingStatus.Ready)
    {
        desiredSize = DisplayInvoice(order, intent);
    }
    else if(interaction.IntentHandlingStatus == INIntentHandlingStatus.Success)
    {
        var response = interaction.IntentResponse as OrderSoupIntentResponse;
        if (!(response is null))
        {
            desiredSize = DisplayOrderConfirmation(order, intent, response);
        }
    }
    completion(true, parameters, desiredSize);
}

ヒント

このメソッドの詳細については、ConfigureViewApple の WWDC 2017 プレゼンテーション「SiriKit の新機能」をご覧ください。

音声ショートカットの作成

Soup Chef には、各注文に音声ショートカットを割り当てるインターフェイスが用意されており、Siri でスープを注文できます。実際、音声ショートカットの録音と割り当てに使用されるインターフェイスは iOS によって提供され、カスタムコードはほとんど必要としません。

OrderDetailViewController では、ユーザーがテーブルの [Siri に追加] 行をタップすると、RowSelected メソッドは、音声ショートカットを追加または編集するための画面を表示します。

public override void RowSelected(UITableView tableView, NSIndexPath indexPath)
{
    // ...
    else if (TableConfiguration.Sections[indexPath.Section].Type == OrderDetailTableConfiguration.SectionType.VoiceShortcut)
    {
        INVoiceShortcut existingShortcut = VoiceShortcutDataManager?.VoiceShortcutForOrder(Order);
        if (!(existingShortcut is null))
        {
            var editVoiceShortcutViewController = new INUIEditVoiceShortcutViewController(existingShortcut);
            editVoiceShortcutViewController.Delegate = this;
            PresentViewController(editVoiceShortcutViewController, true, null);
        }
        else
        {
            // Since the app isn't yet managing a voice shortcut for
            // this order, present the add view controller
            INShortcut newShortcut = new INShortcut(Order.Intent);
            if (!(newShortcut is null))
            {
                var addVoiceShortcutVC = new INUIAddVoiceShortcutViewController(newShortcut);
                addVoiceShortcutVC.Delegate = this;
                PresentViewController(addVoiceShortcutVC, true, null);
            }
        }
    }
}

現在表示されている順序に対して既存の音声ショートカットが存在するかどうかに基づいて、RowSelected は INUIEditVoiceShortcutViewController または INUIAddVoiceShortcutViewController 型のビューコントローラーを表示します。いずれの場合も、OrderDetailViewController はビューコントローラーの Delegate としてそれ自体を設定します。そのため、次も実装します: IINUIAddVoiceShortcutViewControllerDelegate および IINUIEditVoiceShortcutViewControllerDelegate。

デバイスでのテスト

デバイスで Soup Chef を実行するには、このセクションの手順に従います。自動プロビジョニングに関する注意事項も参照してください。

アプリグループ、アプリ ID、プロビジョニングプロファイル

Apple 開発者ポータルの証明書、ID、プロファイル セクションで、次の手順を実行します。

Soup Chef アプリとその拡張機能の間でデータを共有するアプリグループを作成します。例: group.com.yourcompanyname.SoupChef
3 つのアプリ ID を作成します。1 つはアプリ自体用、もう 1 つは Intents の拡張機能用、もう 1 つは Intents UI の拡張機能用です。次に例を示します。
- アプリ: com.yourcompanyname.SoupChef
  - このアプリ ID に、SiriKit とアプリグループの機能を割り当てます。
- Intents の拡張機能: com.yourcompanyname.SoupChef.Intents
  - このアプリ ID に、アプリグループ機能を割り当てます。
- Intents UI の拡張機能: com.yourcompanyname.SoupChef.Intentsui
  - このアプリ ID には特別な機能は必要ありません。
上記のアプリ ID を作成したら、アプリに割り当てられているアプリグループ機能と Intents の拡張機能を編集し、先ほど作成した特定のアプリグループを指定します。
新しいアプリ ID ごとに 1 つずつ、3 つの新しい開発プロビジョニングプロファイルを作成します。
これらのプロビジョニングプロファイルをダウンロードし、各プロファイルをダブルクリックしてインストールします。 Visual Studio for Mac または Visual Studio 2017 が既に実行されている場合は、再起動して、新しいプロビジョニングプロファイルが登録されていることを確認します。

Info.plist、Entitlements.plist、ソースコードの編集

Visual Studio for Mac または Visual Studio 2017 で、次の手順を実行します。

ソリューション内のさまざまな Info.plist ファイルを更新します。アプリ、Intents の拡張機能、Intents UI の拡張機能のバンドル識別子を、前に定義したアプリ ID に設定します。
- アプリ: com.yourcompanyname.SoupChef
- Intents の拡張機能: com.yourcompanyname.SoupChef.Intents
- Intents UI の拡張機能: com.yourcompanyname.SoupChef.Intentsui
SoupChef プロジェクトの Entitlements.plist ファイルを更新します。
- アプリグループ機能の場合は、グループを前に作成した新しいアプリグループに設定します (上の例の group.com.yourcompanyname.SoupChef)。
- SiriKit が有効になっていることを確認します。
SoupChefIntents プロジェクトの Entitlements.plist ファイルを更新します。
- アプリグループ機能の場合は、グループを前に作成した新しいアプリグループに設定します (上の例の group.com.yourcompanyname.SoupChef)。
最後に、NSUserDefaultsHelper.cs を開きます。 AppGroup 変数を新しいアプリグループの値に設定します (たとえば、group.com.yourcompanyname.SoupChef に設定します)。

ビルド設定の構成

Visual Studio for Mac または Visual Studio 2017 の場合:

SoupChef プロジェクトのオプションまたはプロパティを開きます。 [iOS バンドル署名] タブで、署名 ID を自動に設定し、プロビジョニングプロファイルを、前に作成した新しいアプリ固有のプロビジョニングプロファイルに設定します。
SoupChefIntents プロジェクトのオプションまたはプロパティを開きます。 [iOS バンドル署名] タブで、署名 ID を自動に設定し、プロビジョニングプロファイルを、前に作成した新しい Intents の拡張機能固有のプロビジョニングプロファイルに設定します。
SoupChefIntentsUI プロジェクトのオプションまたはプロパティを開きます。 [iOS バンドル署名] タブで、署名 ID を自動に設定し、プロビジョニングプロファイルを、前に作成した新しい Intents UI の拡張機能固有のプロビジョニングプロファイルに設定します。

これらの変更が行われると、アプリは iOS デバイス上で実行されます。

自動プロビジョニング

自動プロビジョニングを使用して、これらのプロビジョニングタスクの多くを IDE で直接実行できます。ただし、自動プロビジョニングではアプリグループは設定されません。新しく作成したアプリグループを含め、それらをダウンロードしてインストールするために、使用するアプリグループの名前を使用して Entitlements.plist ファイルを手動で構成し、Apple 開発者ポータルにアクセスしてアプリグループを作成し、そのアプリグループを自動プロビジョニングによって作成された各アプリ ID に割り当て、プロビジョニングプロファイル (アプリ、Intents の拡張機能、Intents UI の拡張機能) を再生成する必要があります。

次の方法で共有

Xamarin.iOS の Siri ショートカット

サンプル アプリ: Soup Chef

Info.plist と Entitlements.plist

Info.plist

Entitlements.plist

NSUserActivity ショートカットを使用してアプリを開く

NSUserActivity の設定

NSUserActivity ショートカットの処理

NSUserActivity へのフレーズの割り当て

カスタム意図ショートカットを使用したタスクの実行

カスタム意図の定義

カスタム意図の応答の定義

カスタム意図のコードの生成

カスタム意図へのバインドの作成

スタティック ライブラリと C# バインド定義の作成

スタティック ライブラリ プロジェクトのビルド設定の構成

スタティック ライブラリのビルドと C# バインド定義の生成

バインド ライブラリの作成

Swift フレームワークの作成

ソリューションへの意図定義ファイルの追加

意図の寄付

無効な寄付の削除

寄付の成功の検証

Intents の拡張機能の作成

SoupChefIntents - Info.plist と Entitlements.plist

SoupChefIntents - Info.plist

SoupChefIntents - Entitlements.plist

OrderSoupIntent バックグラウンド タスクの処理

アプリを開く OrderSoupIntent の処理

カスタム意図のユーザー インターフェイスの提供

SoupChefIntentsUI - Info.plist と Entitlements.plist

SoupChefIntentsUI - Info.plist

SoupChefIntentsUI - Entitlements.plist

ユーザー インターフェイスの作成

音声ショートカットの作成

デバイスでのテスト

アプリ グループ、アプリ ID、プロビジョニング プロファイル

Info.plist、Entitlements.plist、ソース コードの編集

ビルド設定の構成

自動プロビジョニング

関連リンク

その他のリソース

サンプルアプリ: Soup Chef

スタティックライブラリと C# バインド定義の作成

スタティックライブラリプロジェクトのビルド設定の構成

スタティックライブラリのビルドと C# バインド定義の生成

バインドライブラリの作成

OrderSoupIntent バックグラウンドタスクの処理

カスタム意図のユーザーインターフェイスの提供

ユーザーインターフェイスの作成

アプリグループ、アプリ ID、プロビジョニングプロファイル

Info.plist、Entitlements.plist、ソースコードの編集