SyncSession

セッション オブジェクトによって表されるセッションの現在の状態。

同期セッションの接続の現在の状態。

特定の進行通知ブロックによって追跡される転送方向（アップロードまたはダウンロード）。

アップロードまたはダウンロードされたバイト数をアプリがたとえば「進行状況インジケーター UI 」を表示したい場合は、セッションに進行状況通知ブロックを登録できます。

進行状況通知ブロックの動作。

アップロードまたはダウンロードされたバイト数をアプリがたとえば「進行状況インジケーター UI 」を表示したい場合は、セッションに進行状況通知ブロックを登録できます。

進行状況通知ブロックに対応するトークン。

通知を停止するには、トークンでinvalidate()を呼び出します。 通知ブロックがすでに自動的に停止されている場合は、 invalidate()を呼び出しても何も行われません。 トークンが破棄される前に、 invalidate()を呼び出す必要があります。

進行状況情報と便利なヘルパー メソッドをカプセル化する構造体。

進行状況通知ブロックを登録します。

セッションが同期サブシステムから進行状況情報をすでに受信している場合は、ブロックはすぐに呼び出されます。 それ以外の場合は、進行状況情報が利用可能になるとすぐに呼び出されます。

複数のブロックを一度に同じセッションに登録できます。 各ブロックは進行状況通知専用のサイド キューで呼び出されます。

このメソッドによって返されたトークンは、進行状況通知が必要な限り保持する必要があり、通知が不要になったときはトークンが破棄される前に、 invalidate()メソッドを呼び出してください。

トークンが返されない場合、通知ブロックは再度呼び出されません。 これが当てはまる理由はいくつかあります。 セッションで以前に致命的なエラーが発生したことがある場合は、進行状況通知ブロックは受け入れられません。 ブロックがforCurrentlyOutstandingWorkモードで構成されていたが、報告する追加の進行状況がない場合（たとえば、転送可能なバイト数と転送バイト数が等しい場合）、ブロックは再度呼び出されません。