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
알림을 사용할 수 있을 때 호출할 차단입니다.
반환 값
알림이 전달되기를 원하는 기간 동안 보유해야 하는 토큰입니다.
-
보류 중인 업로드 또는 다운로드가 완료되거나 세션이 만료될 때까지 기다렸다가 콜백을 지정된 대기열로 전달합니다.
~를 참조하세요.
경고
이 메서드는 특히 테스트와 같은 특수한 경우를 제외하고는 MEAN입니다.
선언
Swift
func wait(for direction: ProgressDirection, queue: DispatchQueue? = nil, block: @Sendable @escaping (Error?) -> Void)
매개변수
direction
대기할 전송 방향(업로드 또는 다운로드)입니다.
queue
콜백을 전달할 대기열입니다.
block
대기 시 호출할 차단이 완료되었습니다.
-
wait(for:
비동기식) 보류 중인 업로드 또는 다운로드가 완료되거나 세션이 만료될 때까지 기다립니다.
~를 참조하세요.
경고
이 메서드는 특히 테스트와 같은 특수한 경우를 제외하고는 MEAN입니다.
선언
Swift
@available(macOS 10.15, iOS 13.0, tvOS 13.0, watchOS 6.0, *) func wait(for direction: ProgressDirection) async throws
매개변수
direction
대기할 전송 방향(업로드 또는 다운로드)입니다.