Atlas App Services バックエンドへの接続 - Swift SDK

項目一覧

アプリクライアントへのアクセス

構成
同期接続の共有
同期タイムアウトオプション
サポートされているオペレーティングシステム

Atlas Device SDK は非推奨です。詳細については、の廃止ページを参照してください。

App クライアントは、App Services バックエンドへのインターフェースです。認証機能、関数、 MongoDB Atlas データソースのクエリ、 Device Sync へのアクセスを提供します。

注意

Apple プライバシーマニフェスト

SDK の Apple プライバシーマニフェストは、Atlas への接続、または App クライアントを介したデータの使用をカバーしていません。アプリが App Services に接続し、それを Apple App Store を通じて配布する場合は、アプリの Apple プライバシーマニフェストで独自の情報公開を提供する必要がある場合があります。

詳細については、「 Apple プライバシーマニフェスト」を参照してください。

アプリクライアントへのアクセス

アプリのアプリ ID を渡します。このアプリ IDは、App Services UI で確認できます。

let app = App(id: YOUR_APP_SERVICES_APP_ID) // replace YOUR_APP_SERVICES_APP_ID with your App ID

構成

構成オブジェクトを Appに渡すことができます。

let configuration = AppConfiguration(
   baseURL: "https://services.cloud.mongodb.com", // You can customize base URL
   transport: nil, // Custom RLMNetworkTransportProtocol
   defaultRequestTimeoutMS: 30000
)
let app = App(id: "my-app-services-app-id", configuration: configuration)

複数のアプリに接続するには、複数のアプリクライアントインスタンスを作成します。同じアプリ ID を共有するすべてのアプリクライアントインスタンスは、同じ基礎の接続を使用します。

重要

アプリ初期化後のアプリ構成の変更

Swift SDK バージョン10.46.0以降、アプリ構成でbaseURLを変更し、アプリクライアントは新しいbaseURLを使用します。 Swift SDK バージョン10.45.3以前では、アプリクライアントを初期化すると、構成が内部的にキャッシュされます。アプリを閉じてから、同じプロセス内で変更された構成で再度開いても効果はありません。クライアントはキャッシュされた構成を引き続き使用します。

同期接続の共有

バージョン 10.41.0 の新機能。

AppConfigurationでenableSessionMultiplexingブール値を設定して、Realm Swift SDK が同期された Realm ごとにサーバーへの接続を開くか、すべての同期された Realm のサーバーへの接続を共有するかを指定できます。

このブール値を指定しない場合、Realm はデフォルトで、同期されたすべての Realm に対して App Services ユーザーごとに 1 つの接続を共有します。

let configuration = AppConfiguration(enableSessionMultiplexing: false)
let app = App(id: YOUR_APP_SERVICES_APP_ID, configuration: configuration)

同期タイムアウトオプション

バージョン 10.41.0 の新機能。

AppConfigurationでさまざまな同期タイムアウトオプションを設定できます。 syncTimeoutsプロパティはSyncTimeoutOptionsオブジェクトを受け入れて、これらの設定のデフォルト値を上書きできます。

使用可能なタイムアウト設定とその定義の完全なリストについては、「 RMSyncTimeoutOptions 」を参照してください。

let syncTimeoutOptions = SyncTimeoutOptions(
    connectTimeout: 30000,
    connectionLingerTime: 5000,
    pingKeepalivePeriod: 10000,
    pongKeepaliveTimeout: 10000,
    fastReconnectLimit: 30000
)
let configuration = AppConfiguration(syncTimeouts: syncTimeoutOptions)
let app = App(id: YOUR_APP_SERVICES_APP_ID, configuration: configuration)

サポートされているオペレーティングシステム

Realm Swift SDK は、Xcode バージョンと Realm Swift SDK バージョンに応じて、Apple オペレーティングシステムの範囲向けの Atlas App Services App への接続をサポートしています。 App Services Appに接続すると、次のことが可能になります。

認証とユーザー管理
Atlas Function の呼び出し
MongoDB Atlas データソースのクエリ
デバイスの同期

サポートされているオペレーティングシステムの最新情報については、 OS サポートを参照してください。

現時点では、Realm Swift SDK は watchOS から App Services App への接続をサポートしていません。

戻る

アプリケーションサービス

関数の呼び出し

注意