设置别名
命名空间:
Smobiler.Core.RPC
程序集:
Smobiler.Core (在 Smobiler.Core.dll 中) 版本:6.0.651.17422+f85e28ffe3fdebbfe720c8c2dde0db495f1a52ab
语法public void SetAlias(
string alias,
SetAliasResultHandler handler = null,
int timeout = 60000
)
Public Sub SetAlias (
alias As String,
Optional handler As SetAliasResultHandler = Nothing,
Optional timeout As Integer = 60000
)
参数
- alias
- 类型:SystemString
别名 - handler (Optional)
- 类型:Smobiler.Core.RPCSetAliasResultHandler
ResultHandler 实例 - timeout (Optional)
- 类型:SystemInt32
超时时间(毫秒)
备注
在同一个应用中,别名是唯一的,不能有重复。假设客户端1的别名为A,如果再设置客户端2的别名为A,则客户端1的别名会失效。
设置别名为空字符串,可以取消别名。
别名取值范围为:英文(大小写)、数字、下划线_,长度不超过 128 个字符。
需要注意的是,如果没有主动取消别名(或在另外一个客户端上设置相关的别名),那么即使在客户端关闭后,那么还会收到此别名推送的内容。
设置别名需要向推送服务器发送别名信息,此过程需要一定的时间(具体和网络有关),有可能设置失败,所以请在委托PushAliasSetEventHandler中判断是否设置成功。
参见