カスタムコラボレーションAppをメッセージAppと統合する

カスタムコラボレーションAppをメッセージAppと統合する

SharedWithYouフレームワークが、Appの連携基盤を強化する仕組みをご覧ください。連携コンテンツのセキュアな招待状を送信し、参加者の変更を同期する方法を紹介します。また連携するメッセージ内で、コンテンツの更新情報を表示する方法についても解説します。 SharedWithYouの導入については、WWDC22の「Shared with YouをAppに追加する」をご覧ください。共同制作のUI APIに関する概要については、WWDC22の「メッセージAppで共同制作の体験を強化する」をご覧ください。（注：APIは、今後のベータ版で利用可能になります。)

リソース
- - HDビデオ
  - SDビデオ
関連ビデオ

WWDC22
ダウンロード

♪♪ メッセージ App team の Devin Clary ですメッセージ App engineer の Lance ですカスタム共同制作 App をメッセージ App と統合するお話しですコラボレーション = 共同制作はチャットで始まります iOS16 と macOS Ventura ではカスタムの共同制作体験をチャットの中にそのまま持ち込めます共同制作のライフサイクルを説明します次に App の共同制作コンテンツをメッセージ App で共有できるように準備する方法を紹介します続いてプライバシーを犠牲にすることなく受信者のアクセス権を確認し参加者の変更に対応するために必要なすべてのことを説明します最後にメッセージ App のチャットに App からコンテンツに関する通知をポストする方法ですここでは App に既存の共同制作インフラを持ちユニバーサルリンクをすでに採用していることを想定しています「AppにShared with Youを追加する」や「メッセージAppで共同制作体験を強化する」で紹介したいくつかの概念を基に説明しますまず最初にカスタム共同制作メッセージのライフサイクルを説明しこの API によってユーザーがこれまでよりも迅速に共同制作を開始できるようになることを説明しますユーザーが App からメッセージを通じて共同制作を共有することを決定するとまずコンテンツを表すメタデータを作成しますこのメタデータにはユーザーがメッセージを送信する前に設定できる共有オプションやカスタマイズ可能なその他のプロパティが含まれています次にそのメタデータを共有シートに提供するかドラッグ＆ドロップしますこれによりコンテンツのドラフトがメッセージの作成フィールドにステージングされます共同制作はユニバーサルリンクで表現する必要がありますリンクはすぐにでも作成できますがメッセージを送信する直前まで延期したほうがよいでしょうこれはメッセージ App のリンク作成がメッセージ作成フィールドで設定される共有オプションや受信者に依存する場合に有効です共有オプションと受信者を選択し送信ボタンをタップしますメッセージ App はメッセージが送信される前にユニバーサルリンクとデバイスに依存しないコンテンツの識別子を App に要求しますメッセージ App はその識別子を用いて特定の共同制作メッセージの受信者を表す暗号化された ID を提供しますこの ID を使用すれば受信者はどのデバイスでも共同制作のリンクを開くことができます App はこれらの ID をサーバーに保存し
この手順が完了するとメッセージが受信者に送信されます受信側のデバイスで何が起こるかを説明します目的はアクセスを確認することであり受信者の ID とサーバー上のアカウントをペアリングします受信者がリンクを開くと他のリンクの場合と同様にあなたの App が URLを開くために呼び出されます要求したユーザーアカウントのそのドキュメントへのアクセスが初めての場合受信者のデバイスによって暗号署名されたユーザー ID の認証をシステムに問い合わせます App はその署名付き ID 証明をあなたのサーバーに送信し認証を受けます署名が有効な場合サーバーは送信デバイスから以前に提供された ID と証明書を比較します一致した場合サーバーはそのユーザーからのアクセスを許可しますこれでメッセージ受信者はアカウント情報を交換することなくコンテンツに安全かつ迅速にアクセスできるようになりましたこれが共同制作メッセージのライフサイクルです！共同制作を開始するための APIについて詳しく見てみましょう共同制作にはメタデータが必要です SharedWithYou フレームワークの新しいクラス SWCollaborationMetadata を使用しますこのクラスには共同制作を構成するための以下のプロパティがあります共有前にコンテンツを参照するためのローカル識別子であるコンテンツのタイトル共有元のアカウントについてユーザーに情報を提供する開始者名とアカウントハンドルデフォルトの共有オプションなどですメタデータオブジェクトの作成とプロパティの設定方法を説明します SWLocalCollaborationIdentifier を文字列で初期化しローカル識別子を作成しますこの文字列は App がローカルでコンテンツを識別できれば良くデバイスをまたいで識別する必要はありませんローカル識別子で新しいメタデータインスタンスを初期化します Foundation フレームワークの PersonNameComponents を使用してコンテンツのタイトルイニシエーターのアカウントハンドルと名前を設定しますハンドルと名前はユーザーが共有元のアカウントを確認できるようにローカルにのみ表示されます次に defaultShareOptions の設定ですがその前にオプションの仕組みについて説明します共有オプションはユーザーがメッセージ App や共有シートで設定しますユーザーが選択したオプションはメッセージが送信される前に提供されます共有オプションに含まれるのは誰がコンテンツにアクセスできるのか誰が共同制作に編集を加えることができるかといった項目ですオプションの設定では SWCollaborationOption などのクラスを使いますグループ化の仕方によってオプションは個々のスイッチや設定に対する相互排他な値で表されますオプションはタイトルと識別子を持ち選択されるか選択されないかのどちらかですオプションのグループを表現するために 2つのクラスがあります SWCollaborationOptionsGroup と SWCollaborationOptions PickerGroup スイッチのコレクションには SWCollaborationOptionsGroup を使い SWCollaborationOptions PickerGroup は設定に対して相互に排他な値を表します SWCollaborationShareOptions はメタデータの defaultShareOptions プロパティに設定されるオプショングループの完全なセットを定義しますまたオプションを説明するための要約文字列を提供することもできますオプションクラスの説明に続き次はその使い方の例ですこのコードでは 2 つのオプショングループを定義しています最初のグループは識別子と2 つのオプションで初期化されます識別子はユーザー選択したオプションを後で識別するために使う任意の文字列ですこれはピッカーグループなので選択肢は相互に排他ですこのグループはコンテンツの権限設定 readwrite または readonly を表します最初のオプションがデフォルトで選択されますタイトルにはこのグループを説明する文字列が設定されます 2番目のオプショングループも同様に初期化され 2つのオプションが含まれますこれらは通常のオプションでユーザーの投稿やコメントを個別に許可するかどうかを設定します最後に 2つのオプショングループを利用して SWCollaborationShareOptions のインスタンスを初期化しメタデータに設定しますコンテンツの共有の決定方法に応じてメタデータを共有シートまたはドラッグ＆ドロップに提供します SwiftUI であれば SWCollaborationMetadata は新らしい ShareLink API と互換性があります詳細は「Transferableの紹介」と「SwiftUI の新機能」をご覧ください SwiftUI のプロキシ表現を使った共同制作のサポートがいかに簡単か紹介します Transferable モデルオブジェクトの ProxyRepresentation で共同制作メタデータのインスタンスを返しますそのビューからそのモデルオブジェクトで ShareLink を初期化します UIKit や AppKit では NSItemProvider で共有をサポートします SWCollaborationMetadata は NSItemProviderReading / Writing に準拠しておりメタデータのインスタンスを登録するだけで共同制作のサポートが可能ですできるだけ多くのチャネルで共有をサポートするためにコンテンツの複数の表現を登録します例えばメッセージ App ではファイル表現をサポートすると「コピーを送信」が自動的に提供されます使用するのはUIActivityViewController付き NSItemProvider API を iOS と iPadOS では UIDragItem で macOS では NSSharingServicePicker で使用しますこれは iOS の共有シートの設定です NSItemProvider のインスタンスを作成し前の例で作成した共同制作メタデータを全プロセスに可視と設定した上で登録します UIActivityItemsConfiguration をアイテムプロバイダで初期化し UIActivityViewController をそのコンフィグで初期化します最後にビューコントローラーを表示しますドラッグ＆ドロップに対応させるのも簡単です NSItemProvider を初期化して同じようにメタデータを登録しアイテムプロバイダで UIDragItem を作成してドラッグ＆ドロップ API で使用します API は macOSでも同様で共有ポップオーバー用です再びアイテムプロバイダを設定し今回はこれを用いて NSSharingServicePicker を初期化しますターゲットビューを基準にしてピッカーを表示します macOS でのドラッグ＆ドロップは NSItemProvider ではなく NSPasteboardItem を利用しますこれをサポートするために SharedWithYou は NSPasteboardItem extension をエクスポートしますドラッグ＆ドロップのサポートのためにその extension を利用して新しい NSPasteboardItem のインスタンスにコラボレーションメタデータを設定しますこれだけで共同制作コンテンツの下書きがメッセージ App で表示されます次にユーザーが送信ボタンをタップするとシステムはあなたの App と連携して共有を設定しますこれを行うのは SWCollaborationCoordinator でこれはシングルトンでありグローバル共有のインスタンスを意味します共有インスタンスはデリゲートの actionHandler で共同制作を調整します App は共同制作を調整できるよう必要なときにバックグラウンドで起動されますそのため起動後すぐにデリゲートを登録しタイムアウトを回避するために即座にアクションを処理する必要がありますここでは App の起動終了後に共同制作コーディネーターをセットアップする方法を説明します共有プロパティからシングルトンのコーディネーターのインスタンスにアクセスします App delegate の didFinishLaunchingWithOptions で actionHandler を SWCollaborationActionHandler のプロトコルに準拠したオブジェクトに設定しますアクションハンドラーには SWAction クラスを使用します SWAction は App が実行することを期待されている作業を表しますアクションが終了したら完了をマークしそれ以外は失敗となります App の最初のアクションは共同制作開始のアクションです SWStartCollaborationAction は先に設定した共同制作メタデータを含んでいてユーザーが選択した共有オプションで更新されます必要な設定を行ったらユニバーサルリンクとデバイスに依存しない共同制作の ID を使って開始アクションを完了します明示的に開始アクションを失敗させた場合メッセージはキャンセルされますここではサーバーリクエストの例を用いて開始アクションを処理する実装を示しますまずアクションのメタデータプロパティからローカル識別子とユーザーが選択した共有オプションを取得し識別子とオプションを使って共同制作準備のサーバーリクエストを作りサーバーにリクエストを送信しますここでは非同期の await を使用しています最後にユニバーサルリンクとデバイスに依存しない識別子をレスポンスから取得してアクションを実行しますエラーが発生した場合はアクションを失敗させメッセージをキャンセルします開始アクションが成功した場合システムは共同制作の参加者を更新する 2番目のアクションを App に送信します SWUpdateCollaborationParticipantsAction には参加者の暗号化された ID が含まれていますこの ID は前の開始アクションで作られた共同制作識別子から作られますこれらの識別子はコンテンツに紐づけてサーバーに保存しますこのデータは受信者のデバイスでアクセスの確認に使用されます最後にこのアクションを実行するとメッセージ App でユニバーサルリンクが送信されますこの例では参加者の更新アクションを処理する方法を示していますアクションのメタデータから共同制作識別子を取得します開始アクションを処理する際に作成された識別子です次に addIdentities プロパティを使用してサーバーに保存する参加者データを取得します各 ID は root hash という Data プロパティを持ちますこれは後で使用するためにサーバーに保存しておくべきデータです詳細は後ほどアクセスの検証セクションで Lance が説明します別のサーバーリクエストを設定します今回はターゲット識別子を持つ共同制作に参加者を追加します前と同じようにサーバーにリクエストを送信しアクションを実行または失敗させます今回 fulfill メソッドはパラメーターを受け取りませんこれで共同のセットアップが完了し App はメッセージの受信者からのアクセス許可に必要なものが揃いました Lance がその方法をお見せしますどうも Devin このセクションでは前のステップでサーバーに保存した ID データを使って受信者にアクセスを提供する方法を紹介しますこの検証には SWPersonIdentity の rootHash プロパティを使用しますデバイス上で参加者を一意に識別するために用意された値です検証を実行するためにはルートハッシュの計算方法の理解が必要です紹介しましょう共同制作のメッセージが送信されるとき実際には各人のデバイスに個別に送信されますメッセージ App は暗号の公開鍵を使って各デバイスを識別しますこれらのデバイスにのみアクセス許可することが目的であるためルートハッシュは各受信者に登録された公開鍵から導出しますルートハッシュはマークルツリーと呼ばれるデータ構造のルートノードですマークルツリーは一連のハッシュ操作で構築される二分木です公開鍵に基づきユーザーの ID を導き出すために鍵はこのツリーのリーフとして使用されますマークルツリーで使用されるハッシュアルゴリズムはルートノードがその鍵のセットからしか計算できないことを保証しますこの例ではこのユーザーは３つの機器と３つの公開鍵を持っています鍵は鍵の多様化と呼ばれるプロセスで App の共同制作識別子ごとに一意となります登録された機器数の追跡を防ぐためセットにはランダムの鍵が詰め込まれますツリーのリーフノードは多様化された鍵のパディングセットをハッシュ化することで作成されますこのツリーのハッシュ処理には SHA256 アルゴリズムが使用されます次にリーフノードの各ペアを連結しその親ノードを導き出すためにハッシュ化しますこの処理を親ノードで繰り返し 1つのルートノードが残るまで繰り返しますこれが受信者のデバイス間で受信者の ID を一意に表現するために使用されるルートハッシュです完全なマークルツリーからノードのサブセットを使用してルートハッシュを生成することが可能であることに注意してくださいこのツリーのルートハッシュはハッシュ H4 7 11 と多様化した公開鍵 P3 だけを使って再現することができますまず公開鍵をハッシュし欠落リーフノード H3 を取得し H3 と H4 を使用して H8 を生成しますそして指定された H7 H8 ノードで H10 を生成し最後に H10 と H11 でルートハッシュを生成しますここで重要なのはツリー全体の再構築をしなくても与えられたルートハッシュを生成するために公開鍵 P3 が使われたことを証明できることですこれを行うために必要なノードのサブセットを包含の証明と呼びます App でユニバーサルリンクが開かれると検証が開始されますこれを行うにはリンクの連携の確認が必要です SWCollaborationHighlight は連携リンクで SWHighlightCenter から取得されます共同制作のハイライトを使用して包含の証明を生成します包含証明を表現するには SWPersonIdentityProof クラスを使用します検証を実行するにはオブジェクトを暗号署名で生成しサーバーに送信します getSignedIdentityProof メソッドで証明を取得しますこれは SWCollaborationHighlight とデバイスで署名されたデータです署名を使用することで悪意ある者からの要求を拒否することができますデータはサーバーが要求したチャレンジかデバイスで生成されたナンスですこの例ではチャレンジ方式を採用していますこの URL は App の UIApplicationDelegate のメソッドに渡されますこの URL は共同制作を表すユニバーサルリンクで SWHighlightCenter から該当の SWCollaborationHighlight を取得します次にサーバーにチャレンジを要求し戻ってきたデータを getSignedIdentityProof メソッドにハイライトと一緒に渡すと署名付きの ID 証明が得られますこのデータを検証するためにサーバーが何をすべきかについては後ほど説明しますこれで署名した証明書をサーバーに送って確認できます最後にユーザーインターフェイスをその結果で更新します App はサーバーに公開鍵と署名データと共に証明書を送信しますデータへの署名は P-256 楕円曲線のデジタル署名アルゴリズムで行われハッシュ関数として SHA256 を使用します ID 証明の公開鍵でデータへの署名を検証しますこれは一般的に使用される暗号化ライブラリで実行可能です署名を検証すればその ID 証明が公開鍵のデバイスから送信されたと信頼できます次に ID 証明を使用してルートハッシュを再計算しますこちらは前に見たツリーのサンプルで SWPersonIdentityProof に含まれる例ですこれでルートハッシュを再構築します公開鍵は P3 です包含ハッシュは H4 7 11 ですローカルキーのインデックス 2 がツリー内の公開鍵の位置を示しています証明のプロパティからルートハッシュを再構築する実装の例を次に示します再帰アルゴリズムがツリーデータ構造でうまく機能しています初回起動時に公開鍵のハッシュ包含ハッシュのセットおよび公開鍵のインデックスを渡します次に最初の包含ハッシュが導出され公開鍵のインデックスはその鍵が兄弟鍵の左側にあるか右側にあるかを確認するためにチェックされます選択されたハッシュが正しい順序で連結されハッシュ化されます inclusionHashes 配列で使用済みノードが削除され残りのノードが同関数の再帰呼び出しに渡されます公開鍵のインデックスも更新されツリーの次のノードに対応可能になりますこのシンプルな関数を使用して ID の証明があればルートハッシュをすばやく計算することができますサーバーは生成されたルートハッシュが文書の所有者が持つルートハッシュのリストに含まれるか確認できますこのハッシュは既知のハッシュのリストに含まれているのでサーバーはドキュメントへのアクセスを許可することができますこれで文書へのアクセスを許可できます！本人確認の手順は次のとおりですまずユニバーサルリンクを処理しながらそのコンテンツの共同制作ハイライトを検索し次にデータに署名し包含の証明を取得します署名されたデータと証明書をサーバに送信しデータの署名を確認します包含証明を使用しルートハッシュを生成し最後にルートハッシュをそのコンテンツに関連する既知の ID のリストと比較しますこれでアクセスの確認方法は理解できたと思います次はメッセージ App での参加者の変更について説明しますメッセージ App で共同作業をしているグループチャットの参加者が変更されるとユーザーはメッセージ App のスレッドのバナーでその変更を App に反映させることができますこのシナリオでは App は追加削除された ID を含む別の SWUpdateCollaboration ParticipantsAction を受信します共同制作設定時の処理と同じコードを使いますが参加者の削除処理も必要です削除する場合はその ID を検索しアクセス権を取り消すだけですアカウントがまだ関連付けられていない場合は単純にデータベースからルートハッシュを削除してください Devin が説明した参加者の更新動作の実装を説明しましょうこの例では削除された ID のプロパティを使いそれらを同様の削除要求 API に渡しますこのコードでは削除された ID の処理のみですが完全な実装では追加と削除された ID の処理が必要ですこれで参加者の変更に対応できます！最後に共同制作に変更があると Appはその変更を通知しメッセージ App に表示しますサポートされる通知にはいくつかありますここで説明します通知はリンクが共有されたチャットにバナーとして表示されバナーには変更内容と変更者の説明が表示されますこのチャットで Charlie はパンのレシピに編集を加えました表示ボタンをタップするとすぐに該当のコンテンツに戻れます通知を表すために SWHighlightEvent というプロトコルがありますこれは SWHighlightCenter API から取得した SWHighlights で初期化されますメッセージ App は複数のイベントに対応していますコンテンツの更新やコメントに対する変更参加者の参加退出時のメンバーシップイベントユーザーが言及されたときのメンションイベントコンテンツの移動や削除に関するパーシスタンスイベント以下は編集の変更イベントを共同制作にポストする方法です highlight center API を使用して対象識別子の collaboration highlight を取得しますこれは共同制作開始時に定義した識別子でコンテンツの変更時に App で用意する必要があります次に変更イベントのインスタンスを作成し初期化にはハイライトとトリガー列挙値を指定しますこの場合は edit とします再度ハイライトセンターからそのイベントの通知をポストします同様にメンバーの変更はメンバーシップイベントをポストします今回は addedCollaborator や removedCollaborator を渡しますユーザーのメンションに対応していればメンションイベントをポストできます個人 ID をルートハッシュで初期化しますアクセス認証の際に App の個人アカウントと ID の関連付けを思い出して同様にメンションイベントをポストし言及された ID をパラメータとして渡します通知は該当ユーザーへのメッセージにのみ表示されます最後にコンテンツの移動と名前変更または削除の場合ですパーシスタンスイベントを使用しますここではトリガータイプを使用してユーザーがコンテンツの名前を変更したことを表示します App が共同作業者に通知することでその更新情報をメッセージ App で直接受け取れますいくつかの手順に従い共同制作の機能をメッセージ App と統合する準備ができましたコンテンツの共同制作を設定し参加者のアクセスを暗号化して検証し参加者の変更を追跡しメッセージ App で通知をポストしてユーザーをコンテンツにつなげます共同制作で使う UI 要素の詳細は “メッセージAppで共同制作の体験を強化する”を参照してくださいあなたの App との共同制作を楽しみにしています！これで我々はサインオフしますありがとうございました ♪♪

4:21 - Configure SWCollaborationMetadata

let localIdentifier = SWLocalCollaborationIdentifier(rawValue: "identifier")
let metadata = SWCollaborationMetadata(localIdentifier: localIdentifier)
metadata.title = "Content Title"
metadata.initiatorHandle = "user@example.com"

let formatter = PersonNameComponentsFormatter()
if let components = formatter.personNameComponents(from: "Devin") {
    metadata.initiatorNameComponents = components
}

metadata.defaultShareOptions = ...

6:34 - Configure SWCollaborationShareOptions

let permission = SWCollaborationOptionsPickerGroup(identifier: UUID().uuidString, 
                                                   options: [
    SWCollaborationOption(title: "Can make changes", identifier: UUID().uuidString),
    SWCollaborationOption(title: "Read only", identifier: UUID().uuidString)
])
permission.options[0].isSelected = true
permission.title = "Permission"

let additionalOptions = SWCollaborationOptionsGroup(identifier: UUID().uuidString, 
                                                    options: [
    SWCollaborationOption(title: "Allow mentions", identifier: UUID().uuidString),
    SWCollaborationOption(title: "Allow comments", identifier: UUID().uuidString)
])
additionalOptions.title = "Additional Settings"
let optionsGroups = [permission, additionalOptions]
metadata.defaultShareOptions = SWCollaborationShareOptions(optionsGroups: optionsGroups)

7:58 - SWCollaborationMetadata SwiftUI TransferRepresentation

struct CustomCollaboration: Transferable {
    var name: String

    static var transferRepresentation: some TransferRepresentation {
        ProxyRepresentation { customCollaboration in
            SWCollaborationMetadata(
                localIdentifier: .init(rawValue: "com.example.customcollaboration"),
                title: customCollaboration.name,
                defaultShareOptions: nil,
                initiatorHandle: "johnappleseed@apple.com",
                initiatorNameComponents: nil
            )
        }
    }
}

8:16 - Using a collaboration metadata TransferRepresentation with ShareLink

struct ContentView: View {
    var body: some View {
        ShareLink(item: CustomCollaboration(name: "Example"), preview: .init("Example"))
    }
}

9:08 - iOS Share Sheet

func presentActivityViewController(metadata: SWCollaborationMetadata) {
    let itemProvider = NSItemProvider()
    itemProvider.registerObject(metadata, visibility: .all)
    let activityConfig = UIActivityItemsConfiguration(itemProviders: [itemProvider])
    let shareSheet = UIActivityViewController(activityItemsConfiguration: activityConfig)
    present(shareSheet, animated: true)
}

9:42 - iOS Drag and Drop

func createDragItem(metadata: SWCollaborationMetadata) -> UIDragItem {
    let itemProvider = NSItemProvider()
    itemProvider.registerObject(metadata, visibility: .all)
    return UIDragItem(itemProvider: itemProvider)
}

9:58 - macOS Sharing Popover

func showSharingServicePicker(view: NSView, metadata: SWCollaborationMetadata) {
    let itemProvider = NSItemProvider()
    itemProvider.registerObject(metadata, visibility: .all)
    let picker = NSSharingServicePicker(items: [itemProvider])
    picker.show(relativeTo: view.bounds, of: view, preferredEdge: .minY)
}

10:18 - macOS Drag and Drop NSPasteboardItem extension

func createPasteboardItem(metadata: SWCollaborationMetadata) -> NSPasteboardItem {
    let pasteboardItem = NSPasteboardItem()
    pasteboardItem.collaborationMetadata = metadata
    return pasteboardItem
}

11:22 - Set up SWCollaborationCoordinator

private let collaborationCoordinator = SWCollaborationCoordinator.shared

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]?) -> Bool {
    // Conform to the SWCollaborationActionHandler protocol
    collaborationCoordinator.actionHandler = self
}

12:27 - SWStartCollaborationAction

func collaborationCoordinator(_ coordinator: SWCollaborationCoordinator, 
                              handle action: SWStartCollaborationAction) {
    let localID = action.collaborationMetadata.localIdentifier.rawValue
    let selectedOptions = action.collaborationMetadata.userSelectedShareOptions
    let prepareRequest = APIRequest.PrepareCollaboration(localID: localID, selectedOptions)
    Task {
        do {            
            let response = try await apiController.send(request: prepareRequest)
            let identifier = response.deviceIndependentIdentifier
            action.fulfill(using: response.url, collaborationIdentifier: identifier)
        } catch {
            Log.error("Caught error while preparing the collaboration: \(error)")
            action.fail() // cancels the message
        }
    }
}

13:40 - SWUpdateCollaborationParticipantsAction

func collaborationCoordinator(_ coordinator: SWCollaborationCoordinator, 
                              handle action: SWUpdateCollaborationParticipantsAction) {
    let identifier = action.collaborationMetadata.collaborationIdentifier
    let participants: [Data] = action.addedIdentities.compactMap { $0.rootHash }
    let addParticipants = APIRequest.AddParticipants(identifier: identifier, participants)
    Task {
        do {            
            try await apiController.send(request: addParticipants)
            action.fulfill() // sends the URL provided by the start action
        } catch {
            Log.error("Caught error while adding participants to collaboration: \(error)")
            action.fail() // cancels the message 
        }
    }
}

19:12 - Retrieve a signed identity proof for a highlight

func application(_ app: UIApplication, open url: URL, 
               options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
    let highlightCenter: SWHighlightCenter = self.highlightCenter
    let challengeRequest = APIRequest.GetChallengeData()
    Task {
        do {
            let highlight = try highlightCenter.collaborationHighlight(for: url)
            let challenge = try await apiController.send(request: challengeRequest)
            let proof = try await highlightCenter.getSignedIdentityProof(for: highlight, 
                                                                       using: challenge.data)
    let proofOfInclusionRequest = APIRequest.SubmitProofOfInclusion(for: proof)
            let result = try await apiController.send(request: proofOfInclusionRequest)
            documentController.update(currentDocument, with: result)
        } catch {
            Log.error("Caught error while generating proof of inclusion: \(error)")
        }
    }
}

21:20 - Example code for root hash generation

func generateRootHashFromArray(localHash: SHA256Digest, inclusionHashes: [SHA256Digest], 
                       publicKeyIndex: Int) -> SHA256Digest {
    guard let firstHash = inclusionHashes.first else { return localHash }
    // Check if the node is the left or the right child
    let isLeft = publicKeyIndex.isMultiple(of: 2)
    // Calculate the combined hash
    var rootHash: SHA256Digest
    if isLeft {
        rootHash = hash(concatenate([localHash, firstHash]), using: .sha256)
    } else {
        rootHash = hash(concatenate([firstHash, localHash]), using: .sha256)
    }
    // Recursively pass in elements and move up the Merkle tree
    let newInclusionHashes = inclusionHashes.dropFirst()
    rootHash = generateRootHashFromArray(
        localHash: rootHash,
        inclusionHashes: Array(newInclusionHashes),
        publicKeyIndex: (publicKeyIndex / 2)
    )
    return rootHash
}

24:12 - SWUpdateCollaborationParticipantsAction - removing participants

func collaborationCoordinator(_ coordinator: SWCollaborationCoordinator, 
                              handle action: SWUpdateCollaborationParticipantsAction) {
    // Example of removing participants only. Handle the added identities here too.
    let identifier = action.collaborationMetadata.collaborationIdentifier
    let removed: [Data] = action.removedIdentities.compactMap { $0.rootHash }
    let removeParticipants = APIRequest.RemoveParticipants(identifier: identifier, removed)
    Task {
        do {            
            try await apiController.send(request: removeParticipants)
            action.fulfill()
        } catch {
            log.error("Caught error while adding participants to collaboration: \(error)")
            action.fail()
        }
    }
}

25:54 - Post an SWHighlightChangeEvent Notice

func postContentEditEvent(identifier: SWCollaborationIdentifier) throws {
    let highlightCenter: SWHighlightCenter = self.highlightCenter
    let highlight = try highlightCenter.collaborationHighlight(forIdentifier: identifier)

    let editEvent = SWHighlightChangeEvent(highlight: highlight, trigger: .edit)

    highlightCenter.postNotice(for: editEvent)
}

26:39 - Post an SWHighlightMembershipEvent Notice

func postContentEditEvent(identifier: SWCollaborationIdentifier) throws {
    let highlightCenter: SWHighlightCenter = self.highlightCenter
    let highlight = try highlightCenter.collaborationHighlight(forIdentifier: identifier)

    let editEvent = SWHighlightChangeEvent(highlight: highlight, trigger: .edit)

    highlightCenter.postNotice(for: editEvent)
}

26:50 - Post an SWHighlightMentionEvent Notice

func postMentionEvent(identifier: SWCollaborationIdentifier, mentionedRootHash: Data) throws {
    let mentionedIdentity = SWPerson.Identity(rootHash: mentionedRootHash)

    let highlightCenter: SWHighlightCenter = self.highlightCenter
    let highlight = try highlightCenter.collaborationHighlight(forIdentifier: identifier)

    let mentionEvent = SWHighlightMentionEvent(highlight: highlight,
                                               mentionedPersonIdentity: mentionedIdentity)
    highlightCenter.postNotice(for: mentionEvent)
}

27:23 - Post an SWHighlightPersistenceEvent Notice

func postContentRenamedEvent(identifier: SWCollaborationIdentifier) throws {
    let highlightCenter: SWHighlightCenter = self.highlightCenter
    let highlight = try highlightCenter.collaborationHighlight(forIdentifier: identifier)

    let renamedEvent = SWHighlightPersistenceEvent(highlight: highlight, trigger: .renamed)
    highlightCenter.postNotice(for: renamedEvent)
}

特定のトピックをお探しの場合は、上にトピックを入力すると、関連するトピックにすばやく移動できます。

クエリの送信中にエラーが発生しました。インターネット接続を確認して、もう一度お試しください。

カスタムコラボレーションAppを メッセージAppと統合する

リソース

関連ビデオ

WWDC22