SyncSession

public extension SyncSession
  • 세션 객체가 나타내는 세션의 현재 상태입니다.

    ~를 참조하세요.

    RLMSyncSessionState

    선언

    Swift

    typealias State = RLMSyncSessionState
  • 동기화 세션 연결의 현재 상태입니다.

    ~를 참조하세요.

    RLMSyncConnectionState

    선언

    Swift

    typealias ConnectionState = RLMSyncConnectionState
  • 지정된 진행률 알림 차단에서 추적하는 전송 방향(업로드 또는 다운로드)입니다.

    예를 들어 진행률 표시기 UI를 표시하기 위해 앱에서 업로드 또는 다운로드된 바이트 수를 알리려는 경우 세션에 진행률 알림 차단을 등록할 수 있습니다.

    더 보기

    선언

    Swift

    enum ProgressDirection : Sendable
  • 진행률 알림 차단의 원하는 동작입니다.

    예를 들어 진행률 표시기 UI를 표시하기 위해 앱에서 업로드 또는 다운로드된 바이트 수를 알리려는 경우 세션에 진행률 알림 차단을 등록할 수 있습니다.

    더 보기

    선언

    Swift

    enum ProgressMode : Sendable
  • 진행률 알림 차단에 해당하는 토큰입니다.

    알림을 중지하려면 토큰에서 invalidate() 을(를) 호출합니다. 알림 차단이 이미 자동으로 중지된 경우 invalidate() 을(를) 호출해도 아무 소용이 없습니다. 토큰이 폐기되기 전에 invalidate() 을(를) 호출해야 합니다.

    선언

    Swift

    typealias ProgressNotificationToken = RLMProgressNotificationToken
  • 진행률 정보를 캡슐화하는 구조체입니다.

    더 보기

    선언

    Swift

    struct Progress : Sendable
  • 진행률 알림 차단을 등록합니다.

    세션이 동기화 하위 시스템으로부터 이미 진행 상황 정보를 받은 경우, 차단이 즉시 호출됩니다. 그렇지 않으면 진행률 정보를 사용할 수 있게 되는 즉시 호출됩니다.

    동일한 세션에 한 번에 여러 개의 블록을 등록할 수 있습니다. 각 차단은 진행률 알림 전용 사이드 대기열에서 호출됩니다.

    이 메서드에서 반환된 토큰은 진행률 알림이 필요한 기간 동안 유지되어야 하며, 알림이 더 이상 필요하지 않거나 토큰이 폐기되기 전에 invalidate() 메서드를 호출해야 합니다.

    토큰이 반환되지 않으면 알림 차단이 다시 호출되지 않습니다. 여기에는 여러 가지 이유가 있습니다. 세션에서 이전에 치명적인 오류가 발생한 경우 진행률 알림 차단을 허용하지 않습니다. 차단이 forCurrentlyOutstandingWork 모드에서 구성되었지만 보고할 추가 진행률이 없는 경우(예: 전송 가능한 바이트 수와 전송된 바이트 수가 동일한 경우) 차단이 다시 호출되지 않습니다.

    선언

    Swift

    @preconcurrency
    func addProgressNotification(for direction: ProgressDirection,
                                 mode: ProgressMode,
                                 block: @Sendable @escaping (Progress) -> Void) -> ProgressNotificationToken?

    매개변수

    direction

    이 진행률 알림 차단에서 추적할 전송 방향(업로드 또는 다운로드)입니다.

    mode

    이 진행률 알림 차단의 원하는 동작입니다.

    block

    알림을 사용할 수 있을 때 호출할 차단입니다.

    반환 값

    알림이 전달되기를 원하는 기간 동안 보유해야 하는 토큰입니다.

  • 보류 중인 업로드 또는 다운로드가 완료되거나 세션이 만료될 때까지 기다렸다가 콜백을 지정된 대기열로 전달합니다.

    ~를 참조하세요.

    ProgressDirection

    경고

    이 메서드는 특히 테스트와 같은 특수한 경우를 제외하고는 MEAN입니다.

    선언

    Swift

    func wait(for direction: ProgressDirection,
              queue: DispatchQueue? = nil,
              block: @Sendable @escaping (Error?) -> Void)

    매개변수

    direction

    대기할 전송 방향(업로드 또는 다운로드)입니다.

    queue

    콜백을 전달할 대기열입니다.

    block

    대기 시 호출할 차단이 완료되었습니다.

  • wait(for:) 비동기식

    보류 중인 업로드 또는 다운로드가 완료되거나 세션이 만료될 때까지 기다립니다.

    ~를 참조하세요.

    ProgressDirection

    경고

    이 메서드는 특히 테스트와 같은 특수한 경우를 제외하고는 MEAN입니다.

    선언

    Swift

    @available(macOS 10.15, iOS 13.0, tvOS 13.0, watchOS 6.0, *)
    func wait(for direction: ProgressDirection) async throws

    매개변수

    direction

    대기할 전송 방향(업로드 또는 다운로드)입니다.