メッセージAppで共同制作の体験を強化する

メッセージAppで共同制作の体験を強化する

メッセージAppを使った共同制作で、あなたのAppでのコミュニケーションやコラボレーションを向上させる方法をご覧ください。ドキュメントをメッセージAppの会話と結び付けて、簡単に共有やチャットを行えるようにする方法を紹介します。さらに、会話に参加している全員に、そのドキュメントの最新のアクティビティを知らせる方法について解説します。また、カスタマイズ可能なUI をAppに追加したり、共同制作を詳細に管理したり、ドキュメントをメッセージAppのチャットや FaceTime通話と関連付ける方法についても解説します。 SharedWithYouフレームワークの詳細については、「Shared with YouをAppに追加する」をご覧ください。コラボレーションAPI を、カスタムコラボレーションインフラストラクチャを備えたAppに追加する方法の詳細については、「カスタムコラボレーションAppをメッセージAppと統合する」をご覧ください。（注：APIは、今後のベータ版で利用可能になります。)

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

WWDC22
WWDC21
- CloudKitの新機能
ダウンロード

♪ 心地よいヒップホップ ♪ ♪ Miranda Zhou：こんにちは Miranda です Sharing チームのエンジニアです Elana Stettin：Elana です Messages チームのエンジニアです Miranda：このビデオでは Elana と私がメッセージ App で共同制作を強化する方法を掘り下げますまず機能について紹介しますこの機能を利用するための準備やメッセージ App と連携して共同制作を始める方法を学びます Elana が Messages UI を使った共同制作を App に追加する方法を説明し最後に共同制作が更新された時に最新の状態を維持する方法について説明しますまずメッセージ App での共同制作を紹介します iOS 16 と macOS Ventura では共同制作をしている人のコミュニケーションを改善する簡単な方法が新たに追加されました共同制作者はメッセージ App を介して書類と会話を結び付けることができます共同制作アクティビティはメッセージの会話や進行中の FaceTime通話で表示されますカスタマイズ可能なポップオーバーも App に提供され共同制作の詳細を管理したりメッセージの会話に接続したりできますこれは共有シートやドラッグ＆ドロップなどすでにご利用の技術の上に構築されています次にサポートしている共同制作のインフラストラクチャの種類とそれぞれをメッセージ共同制作に結び付ける方法を説明します私たちは3種類の共同制作インフラストラクチャをサポートしています CloudKitとiCloud Drive そして現在お使いのカスタム共同制作インフラストラクチャですこのセッションでは主に CloudKit と iCloud Drive のケースに注目しますカスタムインフラストラクチャをご利用の場合は「カスタムコラボレーションAppをメッセージAppと統合する」のセッションをご視聴ください CloudKit ベースの共同制作を利用する場合システムが共同制作を認識するためのオブジェクトを作成する新らしい API を用意しましたこれは macOS Sierra の APIをベースにしており NSSharingService で共有の開始または管理が可能です共同制作オブジェクトが出来たら共有を開始または管理するための UIを App のどこで表示しているかを確認します既存の AppKit API は将来廃止されるためメッセージ App との共同制作を行うには新しい API へのアップデートが必要です新しい共同制作オブジェクト API は NSItemProvider を使用します NSItemProvider はシステムサービスが App のデータをシステム上の他のプロセスに転送するために使用されますプロバイダは共同制作アイテムの CKShare か共同制作開始時に CKShare を作成するハンドラを必要としますあなたの App の CKContainer も必要です最後に共同制作のためのアクセス権とパーミッションのオプションを表す CKAllowedSharingOptions のオブジェクトを用意しますオプションの値はこれまで NSCloudSharingServiceDelegate メソッドに要求していた NSCloudKitSharingServiceOptions と同じですこちらが CloudKit 共同制作オブジェクトの作成についての概要です共同制作が開始され準備ハンドラを渡す場合そのハンドラ内で "share" を作成してそれをサーバに保存しますすでに開始している場合は関連する "share" を渡すだけです登録する CKAllowedSharingOptions のインスタンスは許可するオプションのデフォルトセットを返します静的標準プロパティを使用しています CloudKit を採用する場合それをそのまま使うかカスタムの制限を行うオプションのインスタンスを作成します
CloudKit の採用に興味がある方向けに説明すると CloudKit を使うと独自のサーバコードを書かずに iCloudを App のデータベースとして使用できますまたそのデータの一部を他の iCloud ユーザと共有する方法もビルトインされています詳しくは WWDC21 の「CloudKit の新機能」をご覧ください iCloud Drive をお使いの場合共同制作用のオブジェクトはファイルの URL です認識する作業は全てシステムが行いますそれができたら App で共同制作を開始または管理するためのエントリーポイントを特定し編集された新バージョンに置きかえる準備をしますカスタム共同制作インフラストラクチャの場合共同制作オブジェクトは SWCollaborationMetadata となり新しい NSItemProvider API にラップされていますこの API を使用して共同制作 UI を導入する方法の詳細については「カスタムコラボレーションAppをメッセージAppと統合する」をご覧くださいこれで準備ができました次に共同制作を開始します方法は2つあります新しい共同制作モードの共有シートからと iOS 上の Files App と macOS の Finder からメッセージにドラッグ＆ドロップする方法です新しい共有シートの共同制作モードはヘッダの表示で識別でき「共同制作」か「コピーを送信」の選択も可能です共有シートで共同制作を行うには先ほど用意した共同制作オブジェクトを共有シートに渡します macOS ではこの共同制作インジケータは新しい共有ポップオーバーに表示されます共有ポップオーバーにはヘッダーにタイトルと画像続いてよく使う会話相手の候補そして既存の連絡方法が含まれますこちらの詳細については WWDC22 の「AppKitの新機能」をご覧ください iOSとMac Catalystでは UIActivityViewController クラスを使用して共有シートを表示します macOS では NSSharingServicePicker を使用して共有ポップオーバーを表示します共同制作オブジェクトをアクティビティアイテムとして UIActivityViewController に渡し共同制作を有効化して表示します同様に NSSharingServicePicker を共同制作オブジェクトで初期化し共同制作を有効化して表示します CloudKit を採用する場合ヘッダのタイトルと画像を提供するために特別な手段が必要です iOS では UIActivity ItemsConfiguration や UIActivityItemSource などの既存の API を使用してタイトルと imageProvider を持つ LPLinkMetadata オブジェクトを提供します共同制作オブジェクトでコンフィグを作成し共有されるアイテムについての LPLinkMetadata オブジェクトを返すようメタデータプロバイダを設定します最後にそのコンフィグで UIActivityViewController を初期化します macOS ではヘッダメタデータを提供するために NSPreviewRepresenting ActivityItem という新しい API が用意されています詳しくは NSPreviewRepresenting ActivityItem のドキュメントをご参照ください NSPreviewRepresentingActivityIte を使用するにはまずタイトル・画像・アイコンを選択します画像は共有するアイテムを表しアイコンは共有されるアイテムのソース例えば App のアイコンを表示します共同制作オブジェクトタイトル・画像・アイコンを含む NSPreviewRepresenting ActivityItem を作成し NSSharingServicePicker をそのプレビューアイテムで初期化しますうれしいことに共有シートのための新しい SwiftUI ShareLink API は共同制作モードもサポート予定です使用するには共有するアイテムを共有とデータ転送のための新しいプロトコル Transferable に準拠させる必要があります CloudKit 使用者は Transferable アイテムから返される CKShareTransferRepresentation の形で共有・コンテナ・オプションを提供します詳しくは WWDC22 の「Transferableの紹介」と「SwiftUIの最新情報」をご覧くださいここでは CloudKit を使用するメモ App が ShareLink で共有する Transfer オブジェクトを作成する例を紹介しますメモ App は既存の CKShare・CKContainer CKAllowedSharingOptions の existing としてまたは CKContainer CKAllowedSharingOptions とコラボレーションオブジェクトの CKShare を作成および保存するハンドラを持つ prepareShare として構築される CKShareTransferRepresentation を提供します iCloud Driveをご利用の場合ファイルのURL が ShareLink で共有可能な Transferable オブジェクトになりますカスタム共同制作インフラストラクチャの場合に転送可能なオブジェクトから SWCollaborationMetadata を返す方法については「カスタムコラボレーションAppをメッセージAppと統合する」をご覧ください Transferable オブジェクトができたら共有アイテムとして ShareLink のイニシャライザに渡します同時に共有シートのヘッダーを埋めるタイトルと画像を含むプレビューを渡します共有シートの共同制作モードヘッダーで注目すべき機能はアクセス権と権限オプションの概要ですこの概要をタップすると共同制作者が共同制作時に使用するアクセス権や権限オプションを選択するビューが表示されます CloudKit を使用する場合は共同制作オブジェクトに登録されたオプションのセットを表示します iCloud Drive を使用すると iCloud Drive のオプションが標準セットとして表示されますカスタムインフラストラクチャの場合にカスタムオプションを指定してこのビューに表示させる方法については「カスタムコラボレーションAppをメッセージAppと統合する」をご覧ください共同制作を開始する方法にはドラッグ＆ドロップによるものもあります共同制作者はあなたの書類をメッセージにドラッグするだけでそのドキュメントで新たに共同制作可能なリッチリンクを表示しますこのリッチリンクは「共同制作」と「コピーを送信」の選択機能と共同制作オプションを提供します利用するには iOS 16と macOS Ventura の ShareLink から共同制作オブジェクトを提供します以上がメッセージ App との共同制作の準備と始め方です次に Elana と交代し App の共同制作体験を次のレベルに引き上げる方法についてお話します Elana：ありがとう Miranda 始め方が分かりましたので共同制作 UI をあなたの App により深く統合する方法をお話します共同制作体験を充実させるためにこれらの機能を追加しました共同制作ボタンは App のナビゲーションに配置され関連するメッセージグループのグループ写真が表示されますまたボタンの右側にはアクティブな参加者数が表示され他の人が書類に参加していることを示します共同制作ボタンをタップすると新しい共同制作ポップオーバーが表示されますカスタマイズ可能なポップオーバーには共同制作の概要が表示されますワンタップで他の参加者とコミュニケーションを始めることも可能ですこれによりメッセージや FaceTime を使ってリアルタイムに共同制作ができます
これらの UI 要素はすべて SharedWithYou フレームワークの1つのクラス SWCollaborationView で提供されますこのビューはナビゲーション中でボタンビューを表示しています SWCollaborationView を初期化するだけですポップオーバーのレイアウトと表示はお任せくださいカスタムコンテンツを表示するにはビューを提供すればポップオーバーに追加されますでは SWCollaborationView を作成するためのコードを説明します SWCollaborationView を itemProvider で初期化します itemProvider には CloudKit ベースの App の場合は CKShare iCloud Drive ベースの App の場合は fileURL カスタム共同制作インフラストラクチャの場合は SW Collaboration メタデータが含まれます
共同制作ビューの activeParticipantCount プロパティを設定しこのドキュメントのアクティブな参加者の数を表示します collaborationView に contentView プロパティを設定しポップオーバーにカスタムコンテンツを提供します ContentView によってポップオーバーのフルカスタマイズが可能ですここに独自のコンテンツを追加することでユーザーに共同制作の内容をユニークに伝えることができます例えば Pages では ContentView に現在の参加者リストと参加者のカーソルの表示切換が含まれていますでは「管理」ボタンを見てみましょう CloudKit や iCloud Drive を使用する場合このボタンを押すと manage UI が表示され参加者の追加や削除共有設定の変更などができますこれについては後ほどお話しします共同制作ビューの manageButtonTitle プロパティを設定してボタンのタイトルをカスタマイズしますこのプロパティを設定しない場合タイトルはデフォルトの “Manage Share”になります App がカスタム共同制作インフラストラクチャを使用する場合 contentView に独自の管理ボタンを追加してくださいこのボタンは提供されません Mac では Apple のデザイン推奨にしたがってボタンの背景が透明であることを確認してください最後に iOS では collaborationView をカスタムビューとして使用してこのように UIBarButtonItem を作成します Macでは UIBarButtonItem を使って NSToolbarItem を初期化します次にバーボタンアイテムまたはツールバーアイテムを ViewController の navigationItem に追加します先ほど触れたように CloudKit と iCloud Drive を使用する際は共同制作ポップオーバーにボタンが用意されていますこれによりこれまでと同じように共有を管理できます管理 UI への変更はすでにご利用中の UICloudSharingControllerDelegate と NSCloudSharingServiceDelegate のプロトコルを使って検知可能ですこれで新しい共同制作 UI を App に統合する方法についてご理解いただけたと思います次に共同制作の更新を監視し処理する方法について説明します共有の開始と停止を知ることは非常に重要です CloudKit をご利用の方のために CKSystemSharingUIObserver というプロトコルを追加し通知が可能になりましたこのプロトコルを使えば CloudKit Sharing UI を使わず CKShare が保存または削除された時に対応するコールバックを取得できますそのコードをいくつかご紹介します CKContainer を使って Observer を初期化します Observer に CKShare が保存された時に実行されるクロージャを定義し systemSharingUIDidSaveShareBlock に設定しますクロージャで share が正しく保存されていれば共有が開始されたことを示す success の結果と作業用の関連する CKShare が表示されます保存に失敗した場合は failure の結果と関連するエラーが得られますこちらはドキュメントの所有者が共有を停止した場合のクロージャの実装です成功の場合 CKShare は正常に削除されます失敗の場合関連するエラーが渡されます共有の開始と停止だけが表示される項目ではありませんドキュメントの変更をユーザーに通知したいケースもあるかもしれません私たちは共同制作の更新情報をまとめたお知らせを該当するメッセージスレッドのトップにポストできる API を追加しました共同制作者には更新内容と誰が変更したかが表示されます通知を表示するには Shared with You の共同制作専用ハイライトである SWCollaborationHighlight を取得します SWCollaborationHighlight イベントを作成するために使用します SWHighlights と SharedWithYou API の詳細については通知の実装作業を始める前に「Shared with YouをAppに追加する」のセッションをご覧ください CloudKit App を例に様々な通知のポストについてお話します App がカスタム共同制作インフラストラクチャを使用している場合は「カスタムコラボレーションAppをメッセージAppと統合する」のセッションで詳しい手順をご覧ください通知を表現するために SWHighlightEvent というプロトコルを導入しましたハイライトイベントは SWHighlightCenter API から取得した SWHighlights で初期化されますサポートされているイベントタイプはコンテンツの更新やコメントの変更のChangeイベント共同制作でユーザーが言及された時の Mentionイベントコンテンツの移動名称変更削除に対する Persistenceイベント書類参加者が追加または削除されたときの Membershipイベントなどがありますこちらは共同制作で編集が行われた際に Changeイベントをポストする例です highlightCenter API を使用して CKShare URL で共同制作のハイライトを取得しますこの CKShare は共同制作の開始時に定義されたものでコンテンツが変更された時に App が利用できるようにする必要があることにご注意ください次に HighlightChangeEvent のインスタンスを作成しますイニシャライザーはハイライトとトリガー列挙型の値を取ります今回はトリガータイプを edit に設定します最後にそのイベントの通知を highlightCenter にポストします残りのイベントも同様の形式で行われますが唯一の例外は mentionEvent でこれはどのユーザーが言及されたかを示すためにより多くの情報を必要としますこのイベントをポストできるのは App がユーザーへの言及をサポートしている場合のみです取得したハイライトと言及した CKShare の参加者のハンドルを渡して mentionEvent を作成しますこの通知は言及されたユーザーにのみ表示されますコンテンツが移動名称変更削除された時は PersistenceEventタイプを使用しますここではドキュメント名が変更されたことを示すために Renamed トリガータイプが使用されています最後は membershipEvent です membershipEvent については代わりに addedCollaborator と removedCollaborator トリガータイプを使用します mentionevents ではドキュメントのメンバーがどのように変化したかを知らせる通知がポストされますメッセージ App でグループメンバーが変更された場合でも共有したドキュメントの共同制作者を同期することができます CloudKit と iCloud Driveの場合は簡単でシステムが作業を行います共同制作で新しいメンバーがメッセージグループにに追加されるとドキュメントの所有者に共有に追加するように通知されます誰かが削除された場合も同様です
カスタム共同制作インフラストラクチャを持つ App の場合はもう少し作業が必要です SWCollaborationActionHandler API を使う必要があります詳しくは「カスタムコラボレーションAppをメッセージAppと統合する」のセッションをご覧ください
これで CloudKit iCloud Drive または独自の共同制作インフラストラクチャを使っていてもメッセージ App で共同制作を開始しあなたの App に統合する方法が分かりました新しい共有シートとドラッグ＆ドロップAPIを使用して共同制作を開始するための準備をしましょう新しい共同制作 UI を統合し共有したドキュメントで起きていることをカスタマイズして提供しましょう設定ができたらさらに進みメッセージスレッドの中から共同制作の変更を表示する通知を利用しましょう皆さんの App がメッセージの新しい共同制作機能を活用するのを楽しみにしています 2人：ご視聴ありがとうございました

4:08 - Create a CloudKit collaboration item provider

// CloudKit collaboration object

// Starting collaboration
let itemProvider = NSItemProvider()
itemProvider.registerCKShare(container: container, 
                             allowedSharingOptions: CKAllowedSharingOptions.standard, 
                             preparationHandler: {
    // Create your share and save to server, or throw error
    return savedShare
})

// Inviting to existing collaboration
let itemProvider = NSItemProvider()
itemProvider.registerCKShare(share, 
                             container: container, 
                             allowedSharingOptions: CKAllowedSharingOptions.standard)

7:35 - Set up Share Sheet on iOS and Mac Catalyst

// Setting up Share Sheet - iOS and Mac Catalyst

let activityViewController = UIActivityViewController(activityItems: [collaborationObject], applicationActivities: nil)

presentingViewController.present(activityViewController, animated: true)

7:47 - Set up Share Popover on macOS

// Setting up Share Popover - macOS

let sharingServicePicker = NSSharingServicePicker(items: [collaborationObject])

sharingServicePicker.show(relativeTo: view.bounds, of: view, preferredEdge: .minY)

8:22 - Provide metadata for CloudKit collaboration in Share Sheet (iOS, Mac Catalyst)

// Providing CloudKit metadata - iOS

let configuration = UIActivityItemsConfiguration(itemProviders: [collaborationItemProvider])
configuration.perItemMetadataProvider = { (_, key) in
    switch key {
    case .linkPresentationMetadata:
        // Create LPLinkMetadata with title and imageProvider
        return metadata
    default:
        return nil
    }
}

let activityViewController = UIActivityViewController(activityItemsConfiguration: configuration)

9:03 - Provide metadata for CloudKit collaboration in Share Popover (macOS)

// Providing CloudKit metadata - macOS

let title = “Shared Item”
let image = NSImage(contentsOfFile: “Shared_Item_Preview_Image.png”)
let icon = NSImage(contentsOfFile: “App_Icon.png”) // Shared item source

let previewRepresentingItem = NSPreviewRepresentingActivityItem(item: collaborationItemProvider, 
                                                                title: title, 
                                                                image: image, 
                                                                icon: icon)

let picker = NSSharingServicePicker(items: [previewRepresentingItem])

10:21 - Create Transferable object for CloudKit collaboration with ShareLink

// SwiftUI CloudKit Transferable

struct Note: Transferable {
    // Properties of the note e.g. name, preview image, content, ID, …
    var share: CKShare?
    func saveCKShareToServer() async throws -> CKShare { … }

    static var transferRepresentation: some TransferRepresentation {
        CKShareTransferRepresentation { note in
            if let share = note.share {
                return .existing(share, container: container, options: options)
            } else {
                return .prepareShare(container: container, options: options) {
                    return try await note.saveCKShareToServer()
                }
            }
        }
    }
}

11:34 - Adopt ShareLink in SwiftUI

// SwiftUI ShareLink adoption

struct ContentView: View {
    @State let item = ShareItem()

    var body: some View {
        ShareLink(item: item, preview: SharePreview(item.title, image: item.previewImage))
    }
}

14:58 - Initialize the collaborationView

// Collaboration View

let collaborationView = SWCollaborationView(itemProvider: itemProvider)

collaborationView.activeParticipantCount = myModel.activePeople.count

collaborationView.contentView = MyView(model: myModel)

collaborationView.manageButtonTitle = "Custom Manage Button"

18:11 - Observe when CKShare is saved with CKSystemSharingUIObserver

// Observing CKShare Changes

let observer = CKSystemSharingUIObserver(container: container)

observer.systemSharingUIDidSaveShareBlock = { _, result in
    switch result {
    case .success(let share):
        // Handle successfully starting share
    case .failure(let error):
        // Handle error
    }
}

18:47 - Observe when CKShare is removed with CKSystemSharingUIObserver

// Observing CKShare Changes

observer.systemSharingUIDidStopSharingBlock = { _, result in
    switch result {
    case .success(let share):
        // Handle successfully starting share
    case .failure(let error):
        // Handle error
    }
}

20:44 - Posting notice for edit SWHighlightChangeEvent

// Post an SWHighlightChangeEvent Notice

let highlightCenter: SWHighlightCenter = self.highlightCenter

let highlight = try highlightCenter.collaborationHighlight(forURL: ckShareURL, error: &error)

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

highlightCenter.postNotice(for: editEvent)

21:30 - Post an SWHighlightMentionEvent Notice

// Post an SWHighlightMentionEvent Notice

let highlightCenter: SWHighlightCenter = self.highlightCenter

let highlight = try highlightCenter.collaborationHighlight(forURL: ckShareURL, error: &error)

let mentionEvent = SWHighlightMentionEvent(highlight: highlight, 
           mentionedPersonCloudKitShareHandle: ckShareParticipantHandle)

highlightCenter.postNotice(for: mentionEvent)

21:58 - Post an SWHighlightPersistenceEvent Notice

// Post an SWHighlightPersistenceEvent Notice

let highlightCenter: SWHighlightCenter = self.highlightCenter

let highlight = try highlightCenter.collaborationHighlight(forURL: ckShareURL, error: &error)

let renamedEvent = SWHighlightPersistenceEvent(highlight: highlight, trigger: .renamed)

highlightCenter.postNotice(for: renamedEvent)

22:11 - Post an SWHighlightMembershipEvent Notice

// Post an SWHighlightMembershipEvent Notice

let highlightCenter: SWHighlightCenter = self.highlightCenter

let highlight = try highlightCenter.collaborationHighlight(forURL: ckShareURL, error: &error)

let membershipEvent = SWHighlightMembershipEvent(highlight: highlight, 
                                           trigger: .addedCollaborator)

highlightCenter.postNotice(for: membershipEvent)

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

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

リソース

関連ビデオ

WWDC22

WWDC21