上次更新日期：
2026年8月23日
|
也应用至 Adobe Connect 9
了解如何对电话适配器及其设置与示例进行高级配置。
安装 Adobe Connect 时，无论您是否在安装程序中勾选了相关选项，系统都会自动安装所有电话适配器。 若您在安装程序中选择了适配器，则系统会显示该适配器的配置画面。 您可以在安装时配置适配器。 您只能在安装程序中对电话适配器采取基本的配置操作。 您可以手动进行高级配置。
如需了解详细信息，请参阅安装和配置 Adobe Connect。
配置电话适配器
如需配置电话适配器，请在运行安装程序后执行以下操作：
- 在文本编辑器中，打开 [root_install_dir]\TelephonyService\conf\telephony-settings.xml 文件。
- 在此 XML 文件中，定义音频会议提供者的拨入顺序。
- 验证和保存 XML 文件。
- 重新启动 Adobe Connect Central Application Server。
在示例设置中，大括号 ({}) 中的值为占位符。 更新设置时，您需要针对这些参数填入实际数值。
更多信息
下面介绍一些常见的 XML 元素。
XML 元素 |
描述 |
<conf-num> |
音频会议的电话号码。 此元素必须是拨号序列中的第一个元素。 您只能使用一个<conf-num> 元素。 适配器会在大括号 {} 中显示值。 |
<delay> |
拨号序列的延迟时间（以毫秒为单位）。 |
<dtmf> |
DTMF（双音多频）音频。 DTMF 值可包含手机键盘上的任何数字或字符，包括 * 和 #。 |
MeetingOne 适配器设置
基本设置
设置 |
必需 |
描述 |
m1.connect.telephony.api_server |
是 |
MeetingOne 电话 API 服务器的 URL。 |
m1.connect.ftp.ssh |
是 |
表示是否启用 SSH 下载的布尔值（启用为“TRUE”，停用则为“FALSE”）。 默认值为“TRUE”。 |
m1.connect.loglevel |
是 |
日志记录级别。 值可以为“info”或“debug”，视最高调试级别下所需的调试级别而定。 |
m1.connect.telephony.api_ server.login |
是 |
用于登录 MeetingOne 电话 API 服务器的 ID。 |
m1.connect.telephony.api_ server.password |
是 |
与登录 ID 关联的密码。 |
高级设置
设置 |
必需 |
默认值 |
描述 |
MEETINGONE_DTMF_ PREFIX_TOKEN |
是 |
- |
表示 DTMF 条目为令牌的字符。 仅当桥接器上的值有所改动时才会更改此值。 建议值为 *65*。 |
MEETINGONE_TOKEN_LENGTH |
是 |
- |
Connect 为每位参会用户生成的唯一令牌的数字个数。 建议值为 4。 |
MEETINGONE_DTMF_POSTFIX_TOKEN |
是 |
- |
表示令牌已完成的字符，该字符会向 Connect 发出信号，以生成用于合并电话用户与网页用户的令牌。 仅当桥接器上的值有所改动时才会更改此值。 建议值为 #。 |
m1.connect.ftp.delay |
否 |
57,600（16 小时） |
音频下载文件的时长上限（以秒为单位）。 最少是 3600（1 小时）。 |
m1.connect.message.timeout |
否 |
90 |
音频桥接器确认命令的时间上限（以秒为单位）。 建议值为 90 至 120 秒。 |
m1.connect.recording.enabled |
否 |
TRUE |
指示是否启用录制的布尔值。 |
m1.connect.sshdownload.cmd |
是 |
${MEETINGONE_PSFTP_PATH} {0} {1} {2} {3} |
SSH 下载命令 |
m1.connect.telephony.authentication_service_endpoint |
yes |
authentication |
电话验证服务终端 |
m1.connect.telephony.audio_service_endpoint |
yes |
audio |
电话音频服务终端 |
m1.connect.telephony.events_service_endpoint |
yes |
events |
电话音频服务终端 |
MAX_SUB_CONFS |
是 |
20 |
|
MAX_USERS_PER_SUB_CONF |
是 |
150 |
|
示例设置 MeetingOne
以下示例展示的是 MeetingOne 适配器的拨号序列：
<telephony-settings>
<telephony-adaptor id="meetingone-adaptor" class- name="com.meetingone.adobeconnect.MeetingOneAdobeConnectAdaptor" enabled="true" name="{meetingone-adaptor}">
<setting id="MEETINGONE_TOKEN_LENGTH">${MEETINGONE_TOKEN_LENGTH}</setting>
<setting id="MAX_SUB_CONFS">20</setting>
<setting id="MAX_USERS_PER_SUB_CONF">150</setting>
<setting id="MEETINGONE_DTMF_PREFIX_TOKEN">${MEETINGONE_DTMF_PREFIX_TOKEN}</setting>
<setting id="MEETINGONE_DTMF_POSTFIX_TOKEN">${MEETINGONE_DTMF_POSTFIX_TOKEN}</setting>
<setting id="m1.connect.telephony.api_server">https://ape-secure.poweredbyphoenix.net/api</setting>
<setting id="m1.connect.ftp.ssh">${m1.connect.ftp.ssh}</setting>
<setting id="m1.connect.loglevel">${m1.connect.loglevel}</setting>
<setting id="m1.connect.sshdownload.cmd">${MEETINGONE_PSFTP_PATH} {0} {1} {2}
{3}</setting>
<setting id="m1.connect.recording.enabled">${m1.connect.recording.enabled}</setting>
<setting id="m1.connect.telephony.api_server.password">${m1.connect.telephony.api_server.password}
</setting>
<setting id="m1.connect.telephony.api_server.login">${m1.connect.telephony.api_server.login}</setting>
<setting id="m1.connect.telephony.authentication_service_endpoint">authentication</setting>
<setting id="m1.connect.telephony.audio_service_endpoint">audio</setting>
<setting id="m1.connect.telephony.events_service_endpoint">events</setting>
<setting id="m1.connect.ftp.delay">${m1.connect.ftp.delay}</setting>
<setting id="m1.connect.message.timeout">${m1.connect.message.timeout}</setting>
<setting id="DIALIN_NUMBERS">MeetingOne_Access_Number_Argentina MeetingOne_Access_Number_Australia MeetingOne_Access_Number_Austria MeetingOne_Access_Number_Bahrain MeetingOne_Access_Number_Belgium MeetingOne_Access_Number_Brazil MeetingOne_Access_Number_Bulgaria MeetingOne_Access_Number_Canada MeetingOne_Access_Number_China MeetingOne_Access_Number_Cyprus MeetingOne_Access_Number_Czech MeetingOne_Access_Number_Denmark MeetingOne_Access_Number_El_Salvador MeetingOne_Access_Number_Estonia MeetingOne_Access_Number_Finland MeetingOne_Access_Number_France MeetingOne_Access_Number_Germany MeetingOne_Access_Number_Greece MeetingOne_Access_Number_Hungary MeetingOne_Access_Number_Ireland MeetingOne_Access_Number_Israel MeetingOne_Access_Number_Italy MeetingOne_Access_Number_Japan MeetingOne_Access_Number_Latvia MeetingOne_Access_Number_Lithuania MeetingOne_Access_Number_Luxembourg MeetingOne_Access_Number_Mexico MeetingOne_Access_Number_Netherlands MeetingOne_Access_Number_New_Zealand MeetingOne_Access_Number_Norway MeetingOne_Access_Number_Panama MeetingOne_Access_Number_Peru MeetingOne_Access_Number_Poland MeetingOne_Access_Number_Portugal MeetingOne_Access_Number_Romania MeetingOne_Access_Number_Singapore MeetingOne_Access_Number_Slovenia MeetingOne_Access_Number_South_Africa MeetingOne_Access_Number_Spain MeetingOne_Access_Number_Sweden MeetingOne_Access_Number_Switzerland MeetingOne_Access_Number_United_Kingdom MeetingOne_Access_Number_United_States</setting>
<dial-in-sequence>
<conf-num>18008320736</conf-num>
<delay>12000</delay>
<dtmf>*</dtmf>
<dtmf>{x-tel-meetingone-conference-id}</dtmf>
<dtmf>#</dtmf>
<delay>6000</delay>
<dtmf>[uv-token]</dtmf>
</dial-in-sequence>
</telephony-adaptor>
</telephony-settings>
MeetingOne 示例功能
以下示例展示的是 MeetingOne 适配器的 telephony-capabilities.xml 配置：
基本设置 - 欧洲、中东和非洲地区
设置 |
必需 |
描述 |
m1.connect.telephony.api_server |
是 |
MeetingOne EMEA 电话 API 服务器的 URL。 |
m1.connect.ftp.ssh |
是 |
表示是否启用 SSH 下载的布尔值（启用为“TRUE”，禁用则为“FALSE”）。 默认值为“TRUE”。 |
m1.connect.loglevel |
是 |
日志记录级别。 值可以为“info”或“debug”，视最高调试级别下所需的调试级别而定。 |
m1.connect.telephony.api_server.login |
是 |
用于登录 MeetingOne EMEA 电话 API 服务器的 ID。 |
m1.connect.telephony.api_server.password |
是 |
与登录 ID 关联的密码。 |
高级设置 - 欧洲、中东和非洲地区
设置 |
必需 |
默认值 |
描述 |
MEETINGONE_DTMF_PREFIX_TOKEN |
是 |
- |
表示 DTMF 条目为令牌的字符。 仅当桥接器上的值有所改动时才会更改此值。 建议值为 *65*。 |
MEETINGONE_TOKEN_ LENGTH |
是 |
- |
Adobe Connect 为每位参会用户生成的唯一令牌的数字个数。 建议值为 4 |
MEETINGONE_DTMF_POSTFIX_TOKEN |
是 |
- |
表示令牌已完成的字符，该字符会向 Adobe Connect 发出信号，以生成用于合并电话用户与网页用户的令牌。 仅当桥接器上的值有所改动时才会更改此值。 建议值为 #。 |
m1.connect.ftp.delay |
否 |
57,600（16 小时） | 音频下载文件的时长上限（以秒为单位）。 最小值为 3600（1 小时）。 |
m1.connect.message.timeout |
否 |
30 |
音频桥接器确认命令的时间上限（以秒为单位）。 建议值为 30 至 120 秒。 |
m1.connect.recording.enabled |
否 |
TRUE |
指示是否启用录制的布尔值。 |
示例设置 - 欧洲、中东和非洲地区
以下示例展示的是 MeetingOne EMEA 适配器的拨号序列：
<telephony-adaptor class-name="com.meetingone.adobeconnect.emea.AdaptorWrapper" enabled="true" id="meetingone-emea-adaptor" name="{meetingone-emea-adaptor}" use-backup- provider="true" default-recording-source="adaptor" disable-profiles-on-edit="false" disable- profiles-on-disable="false"><setting id="MEETINGONE_TOKEN_LENGTH">${MEETINGONE_TOKEN_LENGTH}</setting>
<setting id="MAX_SUB_CONFS">20</setting>
<setting id="MAX_USERS_PER_SUB_CONF">150</setting>
<setting id="MEETINGONE_DTMF_PREFIX_TOKEN">${MEETINGONE_DTMF_PREFIX_TOKEN}</setting>
<setting id="MEETINGONE_DTMF_POSTFIX_TOKEN">${MEETINGONE_DTMF_POSTFIX_TOKEN}</setting>
<setting id="m1.connect.telephony.api_server">${m1.connect.telephony.api_server}</setting>
<setting id="m1.connect.ftp.ssh">${m1.connect.ftp.ssh}</setting>
<setting id="m1.connect.loglevel">${m1.connect.loglevel}</setting>
<setting id="m1.connect.sshdownload.cmd">${MEETINGONE_PSFTP_PATH} {0} {1} {2}
{3}</setting>
<setting id="m1.connect.recording.enabled">${m1.connect.recording.enabled}</setting>
<setting id="m1.connect.telephony.api_server.password">${m1.connect.telephony.api_server.password}</s etting>
<setting id="m1.connect.telephony.api_server.login">${m1.connect.telephony.api_server.login}</setting
>
<setting id="m1.connect.telephony.authentication_service_endpoint">authentication</setting>
<setting id="m1.connect.telephony.audio_service_endpoint">audio</setting>
<setting id="m1.connect.telephony.events_service_endpoint">events</setting>
<setting id="m1.connect.ftp.delay">${m1.connect.ftp.delay}</setting>
<setting id="m1.connect.message.timeout">${m1.connect.message.timeout}</setting>
<setting id="DIALIN_NUMBERS">MeetingOne_Access_Number_Argentina MeetingOne_Access_Number_Australia MeetingOne_Access_Number_Austria MeetingOne_Access_Number_Bahrain MeetingOne_Access_Number_Belgium MeetingOne_Access_Number_Brazil MeetingOne_Access_Number_Bulgaria MeetingOne_Access_Number_Canada MeetingOne_Access_Number_China MeetingOne_Access_Number_Cyprus MeetingOne_Access_Number_Czech MeetingOne_Access_Number_Denmark MeetingOne_Access_Number_El_Salvador MeetingOne_Access_Number_Estonia MeetingOne_Access_Number_Finland MeetingOne_Access_Number_France MeetingOne_Access_Number_Germany MeetingOne_Access_Number_Greece MeetingOne_Access_Number_Hungary MeetingOne_Access_Number_Ireland MeetingOne_Access_Number_Israel MeetingOne_Access_Number_Italy MeetingOne_Access_Number_Japan MeetingOne_Access_Number_Latvia MeetingOne_Access_Number_Lithuania MeetingOne_Access_Number_Luxembourg MeetingOne_Access_Number_Mexico MeetingOne_Access_Number_Netherlands MeetingOne_Access_Number_New_Zealand MeetingOne_Access_Number_Norway
MeetingOne_Access_Number_Panama MeetingOne_Access_Number_Peru MeetingOne_Access_Number_Poland MeetingOne_Access_Number_Portugal MeetingOne_Access_Number_Romania MeetingOne_Access_Number_Singapore MeetingOne_Access_Number_Slovenia MeetingOne_Access_Number_South_Africa MeetingOne_Access_Number_Spain MeetingOne_Access_Number_Sweden MeetingOne_Access_Number_Switzerland MeetingOne_Access_Number_United_Kingdom MeetingOne_Access_Number_United_States</setting>
<dial-in-sequence>
<conf-num>{conf-num}</conf-num>
<delay>12000</delay>
<dtmf>*</dtmf>
<dtmf>{x-tel-meetingone-conference-id}</dtmf>
<dtmf>#</dtmf>
<delay>12000</delay>
<dtmf>*</dtmf>
<dtmf>{x-tel-meetingone-host-pin}</dtmf>
<dtmf>#</dtmf>
<delay>12000</delay>
<dtmf>[uv-token]</dtmf>
</dial-in-sequence>
</telephony-adaptor>
示例功能 - 欧洲、中东和非洲地区
以下示例展示的是 MeetingOne EMEA 适配器的 telephony-capabilities.xml 配置：
<telephony-adaptor class-name="com.meetingone.adobeconnect.emea.AdaptorWrapper" enabled="true" id="meetingone-emea-adaptor"> <capabilities> <breeze-capabilities> <!-- "dial-out" 和 "dial-out-by-user" 不能同时启用 --> <!-- 另请参见下面的 "call-selected-user" --> <!-- 如果 "dial-out" 为真，则用户的拨出权限由用户角色决定 --> <capability enabled="true" id="dial-out"> <host enabled="true"/> <presenter enabled="true"/> <participant enabled="true"/> </capability> <!-- 如果 "dial-out-by-user" 为真，则用户的拨出权限通过 xml API 调用为个体用户设置。 "dial-out" 和 "dial-out-by-user" 是互斥功能 --> <capability enabled="false" id="dial-out-by-user"/> <!-- 如果 "auto-call-me-dialog" 为真，则在会议开始时，如果用户有拨出权限，"呼叫我"对话框将弹出 --> <capability enabled="true" id="auto-call-me-dialog"/> <!-- 使用正则表达式搜索和替换执行号码遮罩。 默认表达式会屏蔽倒数计数第 5、6、7 位， 忽略中间的所有连字符和空格。 如果号码少于 7 位，则默认表达式匹配失败。 --> <capability enabled="false" id="number-mask"> <search-expression>([0-9])([- ]*)([0-9])([- ]*)([0-9])([- ]*)([0-9])([- ]*)([0-9])([- ]*)([0-9])([- ]*)([0-9])$</search-expression> <replacement-expression>x$2x$4x$6$7$8$9$10$11$12$13</replacement-expression> </capability> </breeze-capabilities> <bridge-capabilities> <capability enabled="true" id="hang-up"/> <capability enabled="true" id="remove-selected-user-enable-hangup"/> <capability enabled="true" id="hold-user"/> <capability enabled="true" id="volume-control"/> <capability enabled="true" id="mute-conference"/> <capability enabled="true" id="token-merge"/> <capability id="telephone-number-hint-format" value="E164"/> <capability enabled="true" id="breakout-room"/> <!-- 音频+web 分组会议室。 --> <capability enabled="true" id="web-audio-breakouts"/> <!-- 真表示会议 UI 没有明确启动音频会议的菜单项。 相反，会议开始会自动伴随音频会议开始 --> <capability enabled="false" id="auto-start-conference"/> <!-- 真表示会议 UI 没有明确停止音频会议的菜单项。 相反，会议停止会自动伴随会议结束 --> <capability enabled="false" id="auto-stop-conference"/> <!-- 真表示会议 UI 允许呼叫选定用户 --> <!-- 另请参见上面的 "dial-out"、"dial-out-by-user"、"auto-call-me-dialog"--> <capability enabled="true" id="call-selected-user"/> </bridge-capabilities> </capabilities> </telephony-adaptor>
设置 |
必需 |
描述 |
| DS | 是 | Reserved. 必须存在。 请注意，我们已将适用于部署跟踪的第一个发行版本设置为 1.1。 |
| DSCountry 代码 | 是 | 数据中心国家/地区代码必须为以下代码之一： USA -> 可在 Universal Voice 中使用的美国免费电话号码 GBR -> 可在 Universal Voice 中使用的英国免费电话号码 |
| LogAltairResponse | 是 | 请勿更改 |
| LogExtraDebug | 是 |
请勿更改 |
| LogSuppressAllByContract | 是 |
对于“许可安装”，请添加此条目并将其设置为 true。 该操作将禁止在 Loopup 端点上进行额外日志记录。 |
| AltairURL | 是 |
默认/基本 Altair 地址。 |
| AthenaURL | 是 |
LoopUp API 服务器。 |
| AthenaVerifySecret | 是 |
LoopUp API 服务器的密码。 |
| SeqUrl | 是 |
Seq 实例地址。 |
| SeqToken | 是 |
Adobe Connect Adapter SEQ 令牌 |
| DTMF_PREFIX_TOKEN |
否 | LoopUp IVR 令牌以 ##5 开头，后接 # 数字 |
| DTMF_PREFIX_TOKEN |
否 | 返回会议（令牌以 . 结尾。） |
| TOKEN_LENGTH |
否 | 3 位数 IVR 令牌。 请勿更改 |
| MAX_SUB_CONFS |
是 |
设置为 0。 不支持分组讨论。 |
| UVMaskDialinCLI_CSV |
是 |
sip:RECORDING 为必填项，并确保已禁用 LoopUp 录制分支（如果存在）。 |
示例设置 - LoopUp
以下示例展示的是 LoopUp 电话适配器的 telephony-settings.xml 配置：
<?xml version="1.0" encoding="UTF-8"?>
<telephony-settings>
<telephony-adaptor id="LoopUp"
class-name="com.loopup.ACAdapter"
enabled="true"
name="LoopUp"
default-provider="true"
disable-profiles-on-edit="false"
disable-profiles-on-disable="false">
<!-- Configuration: Refer to
https://github.com/loopup/ACAdapter/blob/main/README.md#configuration -->
<setting id="DS">1.1</setting>
<setting id="DCCountryCode">USA</setting>
<setting id="LogAltairResponse">false</setting>
<setting id="LogExtraDebug">false</setting>
<setting id="AltairUrl">altair.loopup.com</setting>
<setting id="AthenaUrl">data.loopup.com</setting>
<!-- 警告！ 该值将由 Adobe Telephony Service 转换，
并且将不匹配此源！ 权威文件
https://github.com/loopup/ACAdapter/blob/main/conf/telephony-settings.xml -->
<setting id="AthenaVerifySecret_PASSWORD"></setting>
<setting id="SeqUrl">seq-altair.loopup.com</setting>
<!-- 警告！ 该值将由 Adobe Telephony Service 转换，
并且将不匹配此源！ 权威文件
https://github.com/loopup/ACAdapter/blob/main/conf/telephony-settings.xml -->
<setting id="SeqToken_PASSWORD"></setting>
<setting id="DTMF_PREFIX_TOKEN">##5</setting>
<setting id="DTMF_POSTFIX_TOKEN">#</setting>
<setting id="TOKEN_LENGTH">3</setting>
<setting id="MAX_SUB_CONFS">0</setting>
<!-- 这是一个逗号分隔的列表，包含 Adobe Universal Voice 拨入 LoopUp 网桥的号码的 ANI/CLI，除非在此另有列出，否则会显示为与会者。 -->
<setting id="UVMaskDialinCLI_CSV">sip:RECORDING</setting>
</telephony-adaptor>
</telephony-settings>
示例功能 - LoopUp
以下示例展示的是 LoopUp 电话适配器的 telephony-capabilities.xml 配置：
<?xml version="1.0" encoding="ISO-8859-1" standalone="no"?>
<telephony-capabilities>
<telephony-adaptor id="LoopUp" class-name="com.loopup.ACAdapter" enabled="true">
<capabilities>
<breeze-capabilities>
<!-- "dial-out" 和 "dial-out-by-user" 不能同时启用 -->
<!-- 另请参见下面的 "call-selected-user" -->
<!-- 如果 "dial-out" 为真，则用户的拨出权限由用户角色决定 -->
<capability id="dial-out" enabled="true">
<host enabled="true" />
<presenter enabled="true" />
<participant enabled="true" />
</capability>
<!-- 如果 "dial-out-by-user" 为真，则用户的拨出权限通过 xml API 调用为个体用户设置。 "dial-out" 和 "dial-out-by-user" 是互斥功能 -->
<capability id="dial-out-by-user" enabled="false" />
<!-- 如果 "auto-call-me-dialog" 为真，则在会议开始时，如果用户有拨出权限，"呼叫我"对话框将弹出 -->
<capability id="auto-call-me-dialog" enabled="true" />
<!-- 使用正则表达式搜索和替换执行号码遮罩。 默认表达式会屏蔽倒数计数第 5、6、7 位，
忽略中间的所有连字符和空格。 如果号码少于 7 位，则默认表达式匹配失败。 -->
<capability id="number-mask" enabled="false">
<search-expression>([0-9])([- ]*)([0-9])([- ]*)([0-9])([- ]*)([0-9])([- ]*)([0-9])([- ]*)([0-9])([- ]*)([0-9])$</search-expression>
<replacement-expression>x$2x$4x$6$7$8$9$10$11$12$13</replacement-expression>
</capability>
</breeze-capabilities>
<bridge-capabilities>
<capability id="hang-up" enabled="true" />
<capability id="remove-selected-user-enable-hangup" enabled="true" />
<capability id="hold-user" enabled="true" />
<capability id="volume-control" enabled="false" />
<capability id="token-merge" enabled="true" />
<capability id="mute-all" enabled="false" />
<!-- 音频 + web 分组会议室。 -->
<capability id="breakout-room" enabled="false" />
<capability id="web-audio-breakouts" enabled="true" />
<!-- 真表示会议 UI 没有明确启动音频会议的菜单项。 相反，会议开始会自动伴随音频会议开始 -->
<capability id="auto-start-conference" enabled="false" />
<!-- 真表示会议 UI 没有明确停止音频会议的菜单项。 而是会议停止自动与会议结束同时发生 -->
<capability id="auto-stop-conference" enabled="true" />
<!-- 真表示会议 UI 允许呼出到选定的用户 -->
<!-- 另请参见上面的"dial-out"、"dial-out-by-user"、"auto-call-me-dialog" -->
<capability id="call-selected-user" enabled="true" />
<capability id="telephone-number-hint-format" value="E164" />
</bridge-capabilities>
</capabilities>
</telephony-adaptor>
</telephony-capabilities>
