SyncSession

由会话对象表示的会话的当前状态。

同步会话连接的当前状态。

给定进度通知块跟踪的传输方向（上传或下载）。

如果您的应用希望了解已上传或下载了多少字节，则可以在会话上注册进度通知块，例如显示进度指示器用户界面。

进度通知块的所需行为。

如果您的应用希望了解已上传或下载了多少字节，则可以在会话上注册进度通知块，例如显示进度指示器用户界面。

与进度通知区块相对应的令牌。

对令牌调用invalidate()以停止通知。 如果通知块已自动停止，则调用invalidate()不会执行任何操作。 应在销毁令牌之前调用invalidate() 。

封装进度信息以及有用的辅助方法的结构体。

注册进度通知块。

如果会话已从同步子系统收到进度信息，则将立即调用该区块。 否则，一旦进度信息可用，就会立即调用它。

可以同时在同一个会话中注册多个区块。 每个区块都将在专门用于进度通知的侧队列上被调用。

只要需要进度通知，就必须保留此方法返回的令牌；当不再需要通知时和销毁令牌之前，应对令牌调用invalidate()方法。

如果没有返回令牌，则永远不会再次调用通知块。 造成这种情况的原因有很多。 如果会话以前遇到过致命错误，则它将不接受进度通知块。 如果该区块是在forCurrentlyOutstandingWork模式下配置的，但没有其他进度可报告（例如，可传输字节数和已传输字节数相等），则不会再次调用该区块。