Juphoon | developer

初始化和销毁

本章小节:

接口名称	接口描述
Mtc_CliInit	初始化 ZOS、XML 等资源，初始媒体模块，获取用户列表，启动业务引擎。
Mtc_CliDestroy	关闭所有的业务、协议栈等任务，释放所有内存、媒体等资源。
Mtc_CliDrive	MTC 事件驱动接口，收到 MTF 等组件的 Event 后驱动 RSD 业务分发器。

表 1. 客户端初始化和销毁接口

GUI 显示通知是通过一系列回调实现的，设置相关回调定义如下表所示（其他回调会跟具体业务操作有关联性）：

GUI 回调	回调说明
Mtc_CliCbSetPrint	打印日志重定向
Mtc_CliCbSetEvnt	向 GUI 线程发送 MSF 事件，GUI收到事件后应该调用 Mtc_CliDrive 驱动事件

表 2. 客户端启动 GUI 回调

图 1. 客户端初始化过程

设置客户端预设参数比如：

Mtc_CliCfgSetLogDir 设置客户端日志打印的目录

设置 MTC 业务操作回调 (GUI Callback)以下基本回调需要特别关注：

Mtc_CliCbSetPrint 日志重定向打印函数

Mtc_CliCbSetEvnt 事件驱动处理函数

pfnCb 事件驱动函数，比如当 MTF 等业务框架在运行中上报事件时，需要通知事件给 GUI 线程(比如 Windows PostMessage)， GUI 线程收到通知后调用 Mtc_CliDrive 驱动事件。 MTC 在驱动业务逻辑时，会调用其 GUI 回调通知给 GUI 程序。

调用 Mtc_CliInit 启动客户端系统。

表 3. 客户端初始化过程说明

图 2. 客户端销毁过程

1	用户需要确保会话被管理、配置和日志信息已经保存好。一旦客户端停止，所有相关内存资源会进入无效状态。
2	调用 Mtc_CliDestroy 销毁客户端资源

表 4. 客户端销毁过程说明