SyncSession

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

동기화 세션 연결의 현재 상태입니다.

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

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

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

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

진행률 알림 차단에 해당하는 토큰입니다.

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

진행 정보를 캡슐화하는 구조체와 유용한 도우미 메서드입니다.

진행률 알림 차단을 등록합니다.

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

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

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

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