CloudKit 名前空間
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
CloudKit 名前空間は、iCloud へのアクセスを提供します。
クラス
| Name | 説明 |
|---|---|
| CKAcceptSharesOperation |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKAllowedSharingOptions |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKAsset |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKContainer |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKContainer.Notifications |
CKContainer クラスによって投稿された通知。 |
| CKDatabase |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKDatabaseNotification |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKDatabaseOperation |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKDatabaseSubscription |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKDiscoverAllUserIdentitiesOperation |
システムのアドレス帳で検出可能なすべてのユーザーを取得する操作。 |
| CKDiscoverUserIdentitiesOperation |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKErrorCodeExtensions |
CKErrorCode列挙体の拡張メソッド。 |
| CKErrorFields |
CloudKit で使用されるエラー定数を保持します。 |
| CKFetchDatabaseChangesOperation |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKFetchNotificationChangesOperation |
通知の変更を取得する CKOperation 。 |
| CKFetchRecordChangesOperation |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKFetchRecordsOperation |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKFetchRecordZoneChangesConfiguration |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKFetchRecordZoneChangesOperation |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKFetchRecordZoneChangesOptions |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKFetchRecordZonesOperation |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKFetchShareMetadataOperation |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKFetchShareParticipantsOperation |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKFetchSubscriptionsOperation |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKFetchWebAuthTokenOperation |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKLocationSortDescriptor |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKMarkNotificationsReadOperation |
プッシュ通知を読み取りとしてマークします。 通常、プッシュ通知を使用してレコードの変更を追跡するアプリで使用されます。 |
| CKModifyBadgeOperation |
現在のデバイスまたはすべてのユーザーのデバイスで、アプリのアイコンのバッジを変更する CKOperation 。 |
| CKModifyRecordsOperation |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKModifyRecordZonesOperation |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKModifySubscriptionsOperation |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKNotification |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKNotificationID |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKNotificationInfo |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKOperation |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKOperationConfiguration |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKOperationGroup |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKQuery |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKQueryCursor |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKQueryNotification |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKQueryOperation |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKQuerySubscription |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKRecord |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKRecordID |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKRecordValue |
これは、(プロトコル ICKRecordValueの) インターフェイス プロトコルを実装する型を簡単に作成するには、このクラスをサブクラス化します。 別の方法として、 NSObject のサブクラスを作成し、インターフェイス ICKRecordValueを実装します。 |
| CKRecordZone |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKRecordZoneID |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKRecordZoneNotification |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKRecordZoneSubscription |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKReference |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKServerChangeToken |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKShare |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKShareAccessRequester |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKShareBlockedIdentity |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKShareKeys |
さまざまな CloudKit クラスで使用される定数。 |
| CKShareMetadata |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKShareParticipant |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKShareRequestAccessOperation |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSubscription |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEngine |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEngineAccountChangeEvent |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEngineConfiguration |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEngineDelegate |
これは、(プロトコル ICKSyncEngineDelegateの) インターフェイス プロトコルを実装する型を簡単に作成するには、このクラスをサブクラス化します。 別の方法として、 NSObject のサブクラスを作成し、インターフェイス ICKSyncEngineDelegateを実装します。 |
| CKSyncEngineDelegate_Extensions |
CKSyncEngineDelegate プロトコルからのすべてのメソッドをサポートする ICKSyncEngineDelegate インターフェイスへの拡張メソッド。 |
| CKSyncEngineDidFetchChangesEvent |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEngineDidFetchRecordZoneChangesEvent |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEngineDidSendChangesEvent |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEngineEvent |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEngineFailedRecordSave |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEngineFailedZoneSave |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEngineFetchChangesContext |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEngineFetchChangesOptions |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEngineFetchChangesScope |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEngineFetchedDatabaseChangesEvent |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEngineFetchedRecordDeletion |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEngineFetchedRecordZoneChangesEvent |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEngineFetchedZoneDeletion |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEnginePendingDatabaseChange |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEnginePendingRecordZoneChange |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEnginePendingZoneDelete |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEnginePendingZoneSave |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEngineRecordZoneChangeBatch |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEngineSendChangesContext |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEngineSendChangesOptions |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEngineSendChangesScope |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEngineSentDatabaseChangesEvent |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEngineSentRecordZoneChangesEvent |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEngineState |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEngineStateSerialization |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEngineStateUpdateEvent |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEngineWillFetchChangesEvent |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEngineWillFetchRecordZoneChangesEvent |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEngineWillSendChangesEvent |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSystemSharingUIObserver |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKUserIdentity |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKUserIdentityLookupInfo |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
インターフェイス
| Name | 説明 |
|---|---|
| ICKRecordValue |
このインターフェイスは、Objective-C プロトコル |
| ICKSyncEngineDelegate |
このインターフェイスは、Objective-C プロトコル |
列挙型
| Name | 説明 |
|---|---|
| CKAccountStatus |
ユーザーの iCloud アカウントが使用可能かどうかを示す値を列挙します。 |
| CKApplicationPermissions |
他のアプリ ユーザーが電子メール アドレスで現在のユーザーを検出できることを示す値を列挙します。 |
| CKApplicationPermissionStatus |
アプリケーションがアクセス許可を取得しようとしたときに得ることができる状態を列挙します。 |
| CKDatabaseScope |
データベースがプライベート、共有、パブリックのいずれであるかを示す値を列挙します。 |
| CKErrorCode |
CloudKit エラー条件を列挙します。 |
| CKNotificationType |
プッシュ通知を生成できるイベントを列挙します。 |
| CKOperationGroupTransferSize |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKQueryNotificationReason |
データ ライフサイクル通知をトリガーできる永続的なストレージ イベントを列挙します。 |
| CKQuerySubscriptionOptions |
CKSubscriptionが通知を発生した時刻を列挙します。 |
| CKRecordSavePolicy |
レコードを保存するタイミングとタイミングを制御するポリシーを列挙します。 |
| CKRecordZoneCapabilities |
ゾーンで実行できる特殊な操作を列挙します。 |
| CKRecordZoneEncryptionScope |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKReferenceAction |
ターゲット レコードが削除されたときに参照自体を削除するかどうかを制御する値を列挙します。 |
| CKShareParticipantAcceptanceStatus |
参加要求を共有するための応答を列挙します。 |
| CKShareParticipantPermission |
ユーザー共有のアクセス許可を列挙します。 |
| CKShareParticipantRole |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKShareParticipantType |
共有参加要素の種類を列挙します。 |
| CKSharingParticipantAccessOption |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSharingParticipantPermissionOption |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSubscriptionType |
サブスクリプションの種類を列挙します。 |
| CKSyncEngineAccountChangeType |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEngineEventType |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEnginePendingDatabaseChangeType |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEnginePendingRecordZoneChangeType |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEngineSyncReason |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
| CKSyncEngineZoneDeletionReason |
CloudKit 名前空間は、iCloud へのアクセスを提供します。 |
代理人
注釈
CloudKit 名前空間を使用すると、アプリケーション開発者はアプリケーションと iCloud の間のデータ フローを制御できます。 iCloud は、アプリケーションまたは特定のアプリケーションのすべてのインスタンス間で共有される "パブリック" と、1 人のユーザーに固有の "プライベート" の両方のサーバー側データ ストレージを提供します。 iCloud のストレージとトランスポートは、Apple デバイス間で暗号化および同期されます。 CloudKit では、クライアント側の永続化やデータ キャッシュは提供されません。CloudKit 機能は、ユーザーがアクティブなインターネット接続を持っている間にのみ使用できます。
CloudKit の最上位クラスは CKContainer。 CloudKit コンテナー (Apple ドキュメントでは "Ubiquity コンテナー" とも呼ばれます) は、特定の名前で識別される情報ストアです。 Apple では、"iCloud" という形式の名前を使用することをお勧めします。{逆引き DNS}。{appName}"、たとえば"iCloud.com.mycompany.MyApp"。 開発者は、Apple 開発者ポータルを使用して利用できる iCloud ダッシュボードを使用して、コンテナーを作成して構成する必要があります。
1 つの CKContainer には、アプリのすべてのインスタンス間で共有されるパブリック データ ( PublicCloudDatabase を参照) と、ユーザー固有のデータを含むプライベート データの両方が含まれる場合があります ( PrivateCloudDatabaseを参照)。 iCloud 内では、パブリック データはアプリの iCloud ストレージに格納され、プライベート データはユーザーのプライベート iCloud ストレージに格納されます。 パブリック CKDatabase は、iCloud にログインしているかどうかに関係なく、アプリのすべての接続ユーザーが使用できます。 プライベート CKDatabase は、ユーザーが iCloud にログインしている場合にのみ使用できます。 開発者は、ユーザーのログインまたは接続状態の変更に適切に対応するようにコードを記述する必要があります。
これらのパブリック オブジェクトとプライベート CKDatabase オブジェクトには、構造化レコードが格納されます。 これらは、 CKRecord オブジェクトによって表されます。 これらのレコードは、フィールドに似たキー値データに加えて、大きなオブジェクト CKAsset 直接 (含まれている CKRecordで取得) または参照 (大きなデータの遅延取得を可能にする) として保持できます。
すべての CKRecord インスタンスは、 CKRecordZone内に格納されます。 CKRecordZoneは従来のデータベース インスタンスのようなものです。相互に参照できるが、他のCKRecordZone インスタンスには格納しない複数のCKRecord ストアを含めることができます。CKRecordZone オブジェクトを使用して、複数のCKRecord ストア間でアトミック操作を調整できます。 データベース インスタンスと似ているのは汎用ではありません。たとえば、開発者はFetchRecordAsyncを使用して、ゾーンを参照せずにCKDatabaseから直接CKRecordを取得できます。 既定の CKRecordZone は、 DefaultRecordZone経由で使用できます。 開発者は、CloudKit ダッシュボードを使用して追加のゾーンを作成し、それらを使用してデータを論理的にパーティション分割できます。
CloudKit アプリには、 com.apple.developer.icloud-services エンタイトルメントとアプリ固有のバンドル識別子 (例: "com.mycompany.CloudKitApp") を含むプロビジョニング プロファイルが必要です。 開発者は、このようなプロビジョニング プロファイルを作成して構成する必要があります。
次に、1 つのレコードで動作する CloudKit の一般的な使用方法を示します。
//Create
private async Task<CKRecord> StoreInCloudKit (string name, CLLocation loc, int stationId)
{
string containerName = "iCloud.com.example.CKWork";
var container = CKContainer.FromIdentifier (containerName);
CKDatabase publicDatabase = container.PublicCloudDatabase;
var zoneId = CKRecordZone.DefaultRecordZone ().ZoneId;
var recordType = "StationReferences";
var record = new CKRecord (recordType);
record ["Name"] = new NSString (name);
record ["Position"] = loc;
record ["StationID"] = new NSNumber (stationId);
var storedRecord = await publicDatabase.SaveRecordAsync (record);
return storedRecord;
}
//Retrieve (via ID)
private async Task<CKRecord> AccessCloudKit ()
{
string containerName = "iCloud.com.example.CKWork";
var container = CKContainer.FromIdentifier (containerName);
CKDatabase publicDatabase = container.PublicCloudDatabase;
var recordNameIHappenToKnow = "7eaf0432-2fa4-475f-851a-c6a19b3f8587";
var recordId = new CKRecordID (recordNameIHappenToKnow);
var record = await publicDatabase.FetchRecordAsync (recordId);
return record;
}
//Retrieve (query)
private async Task<CKRecord []> QueryCloudKit ()
{
string containerName = "iCloud.com.example.CKWork";
var container = CKContainer.FromIdentifier (containerName);
CKDatabase publicDatabase = container.PublicCloudDatabase;
var zoneId = CKRecordZone.DefaultRecordZone ().ZoneId;
Console.WriteLine ($"Default zone name = '{zoneId.ZoneName}' owner = '{zoneId.OwnerName}'");
/*
var zoneName = "_defaultZone";
var ownerName = "__defaultOwner__";
var zoneId0 = new CKRecordZoneID (zoneName, ownerName);
Console.WriteLine ($"Assert { zoneId0 == zoneId }");
*/
var recordType = "StationReferences";
var location = new CLLocation (19.7303, -155.056);
var predicate = NSPredicate.FromFormat ("distanceToLocation:fromLocation:(Position, %@) < 100", location);
var query = new CKQuery (recordType, predicate);
var result = await publicDatabase.PerformQueryAsync (query, zoneId);
return result;
}
//Update
private async Task<CKRecord> UpdateInCloudKit (CKDatabase database, CKRecord record, NSString key, NSObject newValue)
{
record [key] = newValue;
var modifiedRecord = await database.SaveRecordAsync (record);
return modifiedRecord;
}
//Delete
private async Task<CKRecordID> DeleteRecord (CKDatabase database, CKRecord record)
{
var id = record.Id;
var deletedId = await database.DeleteRecordAsync (id);
return deletedId;
}