授权SDK使用说明
一般而言,在替换试用版本的dll为授权版本的dll后,并在代码中设置授权的帐号密码,然后重新编译即可。各产品授权SDK的具体使用说明如下。
1. ESFramework、OAUS 授权用户
(1)将服务端项目和客户端项目原来引用的试用版的ESFramework.dll替换为正式版的SDK。
(2)在服务端调用ESPlus.Rapid.RapidEngineFactory.CreateServerEngine()之前,添加如下代码(如果已经有相应的调用,则修改方法的参数值)
ESPlus.GlobalUtil.SetAuthorizedUser("授权帐号", "授权密码");
注:先在代码中搜索一下 SetAuthorizedUser 方法,如果已经有调用了,将方法的参数值改过来就可以了。
(3)如果使用了ESFramework.Boost.dll,那么,请下载ESFramework.Boost项目的源码,使用授权版的ESFramework.dll重新编译。
2. OMCS授权用户
(1)将服务端项目和客户端项目原来引用的试用版的OMCS.dll替换为正式版的SDK。
(2)在服务端创建 MultimediaServer 实例之前,添加如下代码(如果已经有相应的调用,则修改方法的参数值)
OMCS.GlobalUtil.SetAuthorizedUser("授权帐号", "授权密码");
注:先在代码中搜索一下 SetAuthorizedUser 方法,如果已经有调用了,将方法的参数值改过来就可以了。
(3)如果使用了OMCS.Boost.dll,那么,请下载OMCS.Boost项目的源码,使用授权版的OMCS.dll重新编译。
3. StriveEngine授权用户
(1)将服务端项目和客户端项目原来引用的试用版的StriveEngine.dll替换为正式版的SDK。
(2)在服务端调用StriveEngine.NetworkEngineFactory创建网络引擎之前,添加如下代码(如果已经有相应的调用,则修改方法的参数值)
StriveEngine.GlobalUtil.SetAuthorizedUser("授权帐号", "授权密码");
注:先在代码中搜索一下 SetAuthorizedUser 方法,如果已经有调用了,将方法的参数值改过来就可以了。
4. MFile授权用户
(1)将项目原来引用的试用版的Oraycn.MFile.dll替换为正式版的SDK。
(2)在程序Main的开始部分,添加如下代码(如果已经有相应的调用,则修改方法的参数值)
Oraycn.MFile.GlobalUtil.SetAuthorizedUser("授权帐号", "授权密码");
注:先在代码中搜索一下 SetAuthorizedUser 方法,如果已经有调用了,将方法的参数值改过来就可以了。
(3)还需要将OMFile.dll这个非托管库的正式版本拷贝到运行目录下,覆盖对应文件。
5. MCapture授权用户
在程序Main的开始部分,添加如下代码
(1)将项目原来引用的试用版的Oraycn.MCapture.dll替换为正式版的SDK。
(2)在程序Main的开始部分,添加如下代码(如果已经有相应的调用,则修改方法的参数值)
Oraycn.MCapture.GlobalUtil.SetAuthorizedUser("授权帐号", "授权密码");
注:先在代码中搜索一下 SetAuthorizedUser 方法,如果已经有调用了,将方法的参数值改过来就可以了。
6. MPlayer授权用户
(1)将项目原来引用的试用版的Oraycn.MPlayer.dll替换为正式版的SDK。
(2)在程序Main的开始部分,添加如下代码(如果已经有相应的调用,则修改方法的参数值)
Oraycn.MPlayer.GlobalUtil.SetAuthorizedUser("授权帐号", "授权密码");
注:先在代码中搜索一下 SetAuthorizedUser 方法,如果已经有调用了,将方法的参数值改过来就可以了。
7. NPusher授权用户
(1)将项目原来引用的试用版的Oraycn.NPusher.dll替换为正式版的SDK。
(2)在程序Main的开始部分,添加如下代码(如果已经有相应的调用,则修改方法的参数值)
Oraycn.NPusher.GlobalUtil.SetAuthorizedUser("授权帐号", "授权密码");
注:先在代码中搜索一下 SetAuthorizedUser 方法,如果已经有调用了,将方法的参数值改过来就可以了。
(3)还需要将ONPusher.dll这个非托管库的正式版本拷贝到运行目录下,覆盖对应文件。
关于加密狗
如果授权方式使用了加密狗,则需要注意以下三点:
(1)请将 sdog.dll 拷贝到运行目录下。(注意,sdog.dll有x86和x64的版本)
(2)在服务端启动前,先插上加密狗。
(3)服务端运行过程中,请勿拔掉加密狗,否则,服务端引擎会停止运行。
(4)SDog.dll 下载:Windows版本、Linux版本
注:如果需要验证能否识别加密狗,可以下载加密狗检测程序进行测试。
在linux服务器上使用加密狗可按如下步骤:
(1)在linux上安装加密狗驱动。如 sudo dpkg -i sdog-x86_64.deb 。
(2)驱动安装成功后,重启一下服务器。
(3)插上加密狗。
(4)将sdog.so拷贝到运行目录下。
(5)为了能正常检测到加密狗,服务端程序需要sudo权限运行。如 sudo dotnet OrayTalk.Server.NetCore.dll 。
关于授权 OMCS Web 端
如果购买了OMCS Web端,则需要使用正式版的OMCS.dll来重新编译生成OMCS Web插件以及插件安装包。
OMCS Web插件项目以及插件安装包项目下载:OMCS.Boosts.rar
与授权实例运行相关的FAQ
(1)问:服务端实例启动时,报错:Unauthorized user ,Error Code: xxx ! please contact to www.oraycn.com ?
答: 授权失败。对应Error Code的含义如下:100 - 授权帐号错误,101 - 授权密码错误,102 - 过期,103 - 超过授权实例数, 104 - PublicTokenKey错误,106 - 启动码错误 。
如果是因为意外退出服务端引擎(直接杀死进程或终止调试)而导致出现103错误,则要等5分钟之后才能再启动服务端引擎。
(2)问:服务端实例正常运行一段时间后,不再接受新的客户端连接?
答:一般是因为运行过程中,当前服务端实例授权失效导致的。可查看运行目录下的类似 xxx_AuthorizedError.txt 文件中的日志说明。
(3)问:重启服务端实例时报“未授权”的错误,该如何处理?
答:如果是进程异常退出(包括VS停止调试)后重启,请等待5分钟后,再重启。
(4)问:我们正式版的SDK已经部署在服务器上了,而我们在继续开发调试时,使用正式版SDK,就会报“授权失败”,该如何解决?
答:正式发布部署就使用正式版的SDK,而在开发调试时就使用试用版的SDK。最新的试用版SDK可以从这里下载,试用帐号为FreeUser,密码为空字符串。
另外,使用正式版本SDK的客户端是可以连接到使用试用版本SDK的服务端的, 这样,使用正式版SDK的客户端就可以在不用更换SDK的情况下,自由连接到测试服务器或正式服务器,以方便开发调试。