GetLastOffset 方法

返回客户端在某个频道上看到的最后一个消息偏移量。

语法

function GetLastOffset(const aChannel: String): Int64;

参数

名称	类型	描述
`aChannel`	`const String`	要返回其所跟踪偏移量的频道名称。

返回值

在该频道上接收到的最后一个偏移量。当客户端尚未在该频道上接收到任何消息时（或当服务器上未启用消息历史时），返回 0。

备注

当服务器上启用了消息历史时，客户端会保留一个按频道的游标，记录它接收到的最后一条消息的偏移量。这个游标正是普通的 Subscribe 在重新连接时发送的内容，使服务器仅重放客户端错过的消息。使用 GetLastOffset 可检查该游标，例如在应用程序重启之间将其持久化，或驱动显式的 Subscribe(aChannel, aSinceOffset) 重放。

在 .NET 中，对应的 SetLastOffset 和 ClearOffsets 方法可让您恢复或重置所跟踪的游标。

示例

LastOffset := oProtocol.GetLastOffset('news');

返回方法