喧喧客户端

喧喧是由然之协同团队推出的一款轻量级的开源企业聊天软件，属于开源软件，喧喧是一个已经实现基础功能的，跨平台的，轻量级的，非常容易进行二次开发的开源聊天解决方案，需要部署服务器才可以使用，服务器内置在然之协同里，连接到服务器后，您就可以和其他连接到服务器的同事进行沟通。

【使用方法】

　　这里有一个公开的测试服务器供使用：

　　地址：http://demo.ranzhi.org

　　用户：demo

　　密码：demo

　　或用户：demo1, demo2, ... demo10

　　密码：123456

　　注意：测试服务器不能使用传送文件功能。

　　然之协同服务器端部署基本步骤：

　　1、下载安装然之协同；

　　2、下载喧喧然之协同服务器端 xuanxuan-1.0.2-server-rangerteam.zip 并解压缩至server目录；

　　3、合并server目录到然之协同服务目录；

　　4、导入server/db/xuanxuan.sql到然之协同的数据库；

　　5、修改php.ini，确保 php 在 webserver 模式和 cli 模式下的session.save_path指向同一目录；

　　6、Linux 或 Mac 系统在然之服务目录执行./bin/xuanxuan start [-u username]，其中username为然之协同 Apache 服务运行用户，默认为 www-data；Windows 系统在然之服务目录执行x:\xxx\php.exe ./app/xuanxuan/server.php，其中x:\xxx\php.exe为php安装路径。

　　7、服务器的登录地址为然之协同的站点地址，登录帐号和密码为然之协同内对应用户的帐号和密码。

　　8、服务器端和客户端基于 php socket 方案并采用 8080 端口进行通讯，如遇不能登录请检查 php socket 扩展是否加载，8080 端口是否开放。端口配置可在 config/ext/xuanxuan.php 中修改。

　　9、可使用 bin/xuanxuan 控制服务器端的启动、停止、重启、状态查询， bin/xuanxuan -h 获取使用帮助。将 bin/daemon.php 加入计划任务即可实现对服务器端的监控和自动重启。

【使用说明】

用户账号及登录

下面主要以 然之协同 作为服务器端进行说明。

默认情况下，所有然之协同系统内的用户账号都可以作为喧喧的登录账号。启动喧喧之后会打开登录界面。

服务器地址为然之协同站点地址（例如：http://demo.ranzhi.org，如果你正在使用一键安装包，默认情况下然之访问地址格式为 http://IP地址:端口号/ranzhi/），账号和密码为然之协同上对应用户的账号和密码。填写完成后就可以进行登录。

如果登录账号可用，会在本地保存登录信息，方便你下次直接登录。如果你登录过多个账号，你还可以点击服务地址右侧的按钮来切换登录账号。

在切换登录账号对话框中选择要登录的用户来登录。点击列表右侧的删除图标则可以删除在本地保存的账号。

主界面

主界面主要由垂直功能导航和功能区域组成。在垂直功能导航上目前可以使用的功能包括：

查看当前登录用户，右键点击用户头像使用用户菜单；

切换【聊天会话】和【通讯录】功能；

展会和折叠功能导航。

聊天会话

聊天会话界面由会话菜单和聊天窗口组成。

会话菜单

会话菜单主要包括会话列表和创建新会话功能。

会话列表

会话列表包含当前用户所有参与会话。默认按照会话最后活动时间排列。点击会话列表顶部标签按钮可以切换会话列表排序形式。

在会话列表中点击会话名称即可打开会话聊天窗口。

创建新会话

点击会话菜单标签页上的创建会话按钮，打开创建会话对话框。

勾选需要参与会话的联系人，点击创建按钮即可。如果所选择的联系人数目少于 2 个，则直接创建为一对一的会话，如果所选择的联系人数目多余 2 个，则创建为多人讨论组。

会话聊天

在会话聊天窗口中，你可以向当前会话发送 Emoji 表情、文本、图片、文件及屏幕截图。消息发送快捷键为 Enter，如果你需要在消息中输入换行，则可以通过 Shift+Enter 或 Alt+Enter 输入。

【软件特色】

　　1、开聊

　　和服务器上的任何用户开聊，收发表情、图片、截屏、文件样样在行；

　　2、讨论组

　　一个人讨论的不过瘾？随时邀请多人组建个性讨论组；

　　3、公开频道

　　将讨论组公开，任何感兴趣的人都可以加入进来；

　　4、通知及提醒

　　与系统桌面环境集成，即时收到新消息通知；

　　5、会话管理

　　将任意会话（包括讨论组和频道）置顶，精彩内容不容错过，还可以重命名讨论组、为讨论组设置白名单及浏览会话的所有消息历史记录；

　　6、通讯录

　　浏览企业成员信息；

　　7、轻量级服务器端

　　轻松搭配然之协同使用。

【更新日志】

　　更新明细

　　新增视频会议和在会议中使用桌面共享功能，现在任何参与会议的成员都可以选择开启视频，并分享自己的桌面，分享桌面时还可以选择仅分享特定的应用窗口；

　　优化客户端启动速度和界面交互性能；

　　修改了会话侧边栏显示策略，现在默认不会显示侧边栏，除非用户手动打开；

　　减少了所依赖的第三方模块；

　　一些特殊功能使用到的模块采用按需加载策略；

　　减少了界面上一些多余的渲染动作；

　　对于一些没有使用到的不可见控件尽量不进行渲染；

　　优化了搜索策略，现在更快；

　　取消了激活会话时同时激活输入框的默认行为；

　　系统内用户信息会缓存在本地数据库；

　　私人会话列表仅显示已经发生过聊天记录的会话；

　　优化对本地数据库旧数据的兼容，当版本不一致时现在会尝试重建本地数据库而不是出错无法使用；

　　优化一对一视频会议，当对方下线时会议自动结束，当对方离线时则无法发起一对一会议；

　　优化应用扩展界面布局样式；

　　修复用户断线重连之后部分用户在线状态可能显示不正确的问题；

　　修复当系统用户名使用纯数字时消息中的@字符有时会丢失的问题；

　　修复部分界面上部门分组列表上的用户信息可能没有及时更新的问题；

　　修复发送高清表情时有时消息列表没有按预期保持在最底部的问题；

　　修复搜索会话时无法通过快捷键↑、↓来切换选中项的问题；

　　修复无法与从未聊天过的用户一对一进行音视频会议的问题；

　　修复发起会议时“提示用户正忙”可能不符合实际情况的问题；

　　修复发起全员会议时参与者没有收到提醒，而是显示为“已忽略”的问题；

　　修复用户登录过程中当用户账号被锁定时错误提示不清晰的问题；

　　修复用户输错一次密码时，可能导致后端记录若干次登录失败从而锁定账户的问题；

　　修复下载文件失败后，文件会无法再次下载；

　　修复了当服务器没有部门数据时客户端登录后可能无法正常使用的问题；

　　修复在讨论组列表取消已存档后列表没有及时更新的问题；

　　修复通过集成 API 向客户端推送通知时，当通知发送者 ID 属性为数值类型时导致客户端界面白屏的问题；

　　修复无法在多显示器条件下使用截屏功能的问题；

　　修复有时无法打开个人资料弹出面板的问题；

　　部署和开发相关：

　　客户端（XXC）：

　　优化了调试版右键“审查元素”菜单，现在不会在文本输入元素上显示此菜单（确保调试版也能访问右键菜单复制、粘贴等文本编辑功能）；

　　修复了极端情况下可能导致 Socket 数据包无法接收到服务器响应的问题；

　　修复了在扩展中通过 const xext = require('xext') 引用扩展 API 出错的问题；

　　消息中转服务器 (XXD)：

　　增加了新的配置项 enableAES 用于设置是否开启 XXD 与 XXB 之间的数据加密（此配置项默认为 1，当 XXD 和 XXB 在同一台服务器上时可以设置为 0 来关闭数据加密从而提升性能），此配置项需要同时在 XXB 中进行对应的设置才会生效；

　　提升了 JSON 解析和编码性能；

　　修复了有时因请求过多导致服务崩溃的问题；

　　后端服务器（XXB）：

　　新增对音视频会议相关参数设置功能页面；

　　Android 推送方案更改为腾讯移动推送 TPNS（原信鸽已不再被腾讯支持），用户只需要重新申请 TPNS 推送密钥即可；

　　优化了推送方案，现在改为通过 XXD 轮询来处理移动消息推送；

　　优化了 PHP 性能；

　　提升了 MySQL 查询性能；

　　支持在 config/my.php 中通过设置 $config->disableSystemGroupChat = true; 来禁用系统会话；