AXIS Audio Manager Center

AXIS Audio Manager Center是一种安全且可扩展的解决方案，用于大型、复杂的音频系统的远程管理和监控。

• 编排您的音频场所 - 您可以将您的AXIS Audio Manager Edge音频场所编排在适合您的企业的结构中。

示例

名为“法国”的位置可能包含一个名为“巴黎”的位置，而后者又包含大多数位于巴黎的音频场所。

示例

名为“南部销售区域”的位置可能包含属于该地区的大多数城市，而该区域又包含位于这些城市中的大多数音频场所。

• 监控您的系统 - 仪表板和音频场所视图提供了系统的概览。过滤功能让故障排查更轻松。

• 远程访问您的场所 - 从场所视图以安全的方式远程访问您的场所的用户界面。

• 管理用户 — 邀请用户并将每个用户添加到一个或多个用户组。每个用户组都被授予了一个特定访问权限，并分配到音频场所结构中的位置或音频场所。

示例

单个用户可以属于具有针对欧洲的内容管理员权限的组，也可以属于具有针对法国巴黎音频场所的管理员权限的组。

• 高级功能

• • 调度 - 为多个音频场所计划通知、广告和音乐。

有关每个 AXIS Audio Manager Center 版本的新功能，请访问 help.axis.com/whats-new-in-axis-audio-manager-center。

• 您需要设置和配置至少一个 AXIS Audio Manager Edge 音频场所。有关更多信息，请访问 AXIS Audio Manager Edge 用户手册。

• 要启用 AXIS Audio Manager Edge 和 AXIS Audio Manager Center 之间的通信，必须为主设备所在的网络中的出站流量打开以下端口：

• DNS	端口	信息
  dispatchse1-st.axis.com ​dispatchse2-st.axis.com ​dispatcher-st.axis.com ​dispatchus1-st.axis.com dispatchjp1-st.axis.com	443, 80 出站，TCP	专用设备通信通道。需要其中一个端口。仅当端口 443 不可用时，才使用端口 80。
  *.devices.audiomanager.axis.com	443 出站，TCP	专用设备通信通道。
  a1ecdk2dyb75d7-ats.iot.eu-west-1.amazonaws.com	8883 出站，TCP	MQTT 通道用于从设备向云服务发送和接收数据。
  content.audiomanager.axis.com	443 出站，TCP	需要在日程安排中进行内容分发。

1. 在网页浏览器中的转到 audiomanager.axis.com。

2. 使用您的My Axis账户的凭证登录。如果您没有My Axis账户，则您可从登录窗口创建一个。

3. 首次登录时，您必须创建您的企业。

当您被邀请参加某个企业时，您将收到一封电子邮件，其中包含来自 AXIS Audio Manager Center 的主题为“用户加入企业邀请”的邀请链接。

1. 要接受邀请，请单击包含的链接或将其粘贴到您的浏览器中。

2. 使用您的 MyAxis 账户的凭证登录。如果您没有 MyAxis 账户，则您可从登录窗口创建一个。

3. 您将自动路由到发出邀请的企业。

将您的音频场所组织在能够方便地查找组织中的场所或场所组的结构中。您可以通过选择结构中的位置来分配用户访问单个音频场所或音频场所组。有关详细信息，请参见 管理用户。

1. 转到Audio sites（音频场所）。

2. 要创建位置：

3. 1. 转到结构中的某个位置。

   2. 单击 + CREATE（创建）。

   3. 命名位置，然后单击创建。

示例

在您要添加的音频场所中启用AXIS Audio Manager Center 集成：

1. 从本地登录您的 AXIS Audio Manager Edge 音频场所。

2. 转到系统设置 > 连接。

3. 选择 AXIS Audio Manager Center 集成的复选框。

4. 如果需要，请选择 AXIS Audio Manager Center O3C 代理服务器并输入您的组织的代理服务器详细信息，以了解音频场所所在的网络。

5. 单击 SAVE（保存）。

将音频场所添加到一个地点：

1. 在 AXIS Audio Manager Center 中，转到Audio sites（音频场所）。

2. 在结构中选择位置。

3. 单击 + ADD AUDIO SITE（+ 添加音频场所）。

4. 在音频场所中输入用作领导者的设备的场所名称、序列号（MAC 地址）和 OAK 密钥（物主身份验证密钥）。

   格式示例：
   - S/N: XXXXXXXXXXXX (12 digit hexadecimal)
   - OAK: XXXXXXXXXXXX (12 digit hexadecimal)

   要查找 OAK 密钥，请执行以下操作：

5. 1. 从本地登录您的 AXIS Audio Manager Edge 音频场所。

   2. 转到系统设置 > 主设备设置。

   3. 单击前往设备设置。

   4. 转到系统 > 网络。

   5. 在 一次单击云连接和所有者身份验证密钥 (OAK) 下，单击 获取密钥。

   6. 注意

      您可在音频系统中作为首要设备的产品附带的备注中找到序列号（MAC地址）和OAK密钥（所有者身份验证密钥）。

      当您丢失备注时，请联系 Axis。接收新密钥需要所有权的证明。

6. 设置音频站点的地理位置：

7. 1. 选择Place audio site on map（在地图上放置音频场所）。

   2. 在搜索中输入地址以放大该位置。

   3. 单击映射以添加位置。

8. 要稍后更改或删除位置，请转到Audio sites（音频场所），单击音频场所的行以显示场所详细信息，然后向下滚动到地图。

1. 转到Audio sites（音频场所）。

2. 单击一个音频场所的行，即可查看其详细信息。

   您也可以单击地图上的音频场所。

3. 查看和编辑音频场所详细信息：

4. • 查找有关主设备的信息，例如AXIS OS版本、序列号和产品名称。

   • 编辑或移除地图上的地理位置。

   • 查看或更改音频场所的开放时间。

   • 下载服务器报告文件以进行故障排查。

在您创建一个新企业时，您将成为该企业的拥有者，并因此被分配最高访问权限，成为Organization administrators（企业管理员）组的成员。属于此组的用户将拥有对企业内配置的完全读写访问权限，包括大多数位置和场所。若要转移拥有权，必须将用户提升为拥有者角色。企业必须至少有一个拥有者。

为了使用 AXIS Audio Manager Center，您必须注册为企业中的用户。有四个预定义的用户角色：

• 管理员 – 管理员拥有对分配至其用户组的位置和音频场所的读/写访问权限。如果在音频场所结构中分配了一个位置，则他们可以在该位置下添加新的位置和音频场所。

• 内容管理者 — 内容管理者能够在分配至其用户组的大多数音频场所中访问以上载和安排内容（音乐、广告和通知）。如果在音频场所结构中分配了一个位置，则他们可以访问此位置以下的大多数音频场所。内容管理人员还可设置开始时间并为其分配的音频场所设置音乐音量。

• 播放操作员 – 播放操作员有权在分配给其用户组的大多数场所中音频访问以设置音乐音量。如果在音频场所结构中分配了一个位置，则他们可以访问此位置以下的大多数音频场所。

用户的总访问权限是由其成员的用户组决定的。每个用户组都有一个已定义的用户角色，并拥有分配给该组的音频场所。一个用户可以是多个用户组的成员，而针对特定音频场所的更高访问权限优先于该用户。

示例

想象一下属于以下两个组的用户：

• 群体： 法国的内容管理者

• • 用户角色： 内容管理人

  • 地点： 法国

• 群体： 管理员巴黎

• • 用户角色： 管理员

  • 地点：巴黎（子位置到法国）

用户将拥有对法国大多数音频场所的内容管理权限，除了巴黎中的大多数场所，用户对其具有管理员权限。这是因为，管理员权限比内容管理权限更高。当用户属于多个组时，多个用户角色可能应用于同一个位置。发生这种情况时，只有具有更高访问权限级别的用户角色才会应用到该位置。

1. 邀请用户加入您的企业：

2. 转到用户管理。

3. 注意

   仅限所有者和企业级管理员使用。

4. 创建用户组并为其分配用户角色和音频场所访问权限：

5. 1. 单击 CREATE（创建）。

   2. 命名用户组。

   3. 选择用户角色。

   4. 单击 CREATE（创建）。

   5. 单击位置旁边的添加。

   6. 选择一个音频场所访问一个单独的音频场所，或选择一个位置访问该位置下面大多数的音频场所。

6. 邀请新用户加入用户组：

7. 1. 单击成员旁边的添加。

   2. 单击邀请用户。

   3. 输入您希望邀请的用户的电子邮件地址。

      已预选用户组。

   4. 撰写将包含在邀请邮件中的邮件。

   5. 单击邀请。

受邀请的用户将收到一封电子邮件，其中包含指向您的企业的链接。当它们跟踪链接时，系统将提示他们登录，然后将其自动路由到正确的企业。一个用户可以是多个企业的成员。

1. 将现有用户添加到用户组：

2. 转到用户管理。

3. 选择应将用户添加到的用户组。

4. 单击成员旁边的添加。

5. 在列表中找到用户，然后单击添加。

您的系统状态可从仪表板监控，您可从中获得有关您的音频场所的连接状态以及您的组织内大多数设备的连接状态的信息。大部分信息也在Audio sites（音频场所）视图中提供。

1. 前往仪表板。

2. 检查音频场所的状态和计划。

3. 调查您的音频场所：

4. 1. 转到Audio sites（音频场所）。

   2. 单击音频场所列表上方的筛选器图标，然后选择要调查的问题。

      有关每种类型的问题的信息，请参阅 故障排查。

   3. 要调查某个音频场所，请单击 > 打开 AXIS Audio Manager Edge。

5. 调查您的时间表：

6. 1. 转到预置。

   2. 单击时间列表上方的过滤器图标，然后选择要调查的问题。

      有关每种类型的问题的信息，请参阅 故障排查。

   3. 要调查时间表，请单击列表中的行。

AXIS Audio Manager Center 可针对音频场所发生的不同类型的事件发送电子邮件和 Webhook 通知。

只有管理员可以设置通知。

您必须是企业级管理员才能设置电子邮件通知。

1. 转到通知。

2. 单击 + CREATE（创建）。

3. 为您的通知命名。

4. 选择电子邮件。

5. 单击 Next（下一步）。

6. 输入接受者的电子邮件。

7. 选择通知触发器。

8. 单击 Create（创建）。

9. 接受者将收到一封包含确认请求的电子邮件。单击电子邮件中的确认后，接受者将开始接收通知。

10. 刷新浏览器检查确认通知状态已从未完成变更为确定，这表明接受者已确认该通知。

1. 转到通知。

2. 单击 + CREATE（创建）。

3. 为您的通知命名。

4. 选择 Webhook。

5. 单击 Next（下一步）。

6. 输入接受者的详细信息。

7. 选择通知触发器。

8. 要选择位置，单击 + 选择。

9. 单击 Create（创建）。

AXIS Audio Manager Center 提供了对已添加音频场所的安全远程访问。这使您可以使用本地  AXIS Audio Manager Edge系统来实现远程音频场所配置。访问音频场所时，您的用户角色或用户组的权限将决定您将能够远程执行的操作。管理员拥有对音频场所中大多数设置的完全访问权限，而内容管理器和播放操作员则具有有限的访问权限。

1. 打开AXIS Audio Manager Edge：

2. 转到Audio sites（音频场所）并找到您的音频场所。

3. 单击 > 打开AXIS Audio Manager Edge。

当您设置了 AXIS Audio Manager Center，并为您的用户分配了用户及其权限时，这些用户即可通过 iOS 和 Android 上的 AXIS Audio Manager 移动应用程序访问音频系统。

通过在移动应用中选择远程连接，您的用户可以登录到 AXIS Audio Manager Center，然后选择要控制的音频场所。

事件日志包含您担任管理员的组织部门中发生的事件。

1. 转到事件日志。

2. 单击数据选择。

3. 选择时间帧。

4. • 相对值：选择您希望从当前时间点往前追溯多长时间来检索数据。

   • 绝对值：选择您想要从中检索数据的时间间隔。

5. 要添加筛选器，单击 + 筛选器并选择条件。

6. 在顺序下，选择如何呈现检索到的数据。

7. 要将检索到的数据导出为 CSV 文件，单击导出。

AXIS Audio Manager Center 具有只有在您的企业获得许可时才可用的功能。这些功能通常是高级功能，可同时在多个音频场所上执行操作，如内容分发或音乐的批计划。

AXIS Audio Manager Center支持将内容文件分发至音频场所进行本地调度。对于每个音频场所，内容将存储在首要设备上，并添加到相应内容类型的库中。这些文件不会自动添加到时间表。

支持的文件格式：mp3、mpeg、ogg、opus、wave

允许的更大文件大小：20 MB

1. 转到 Distribute audio files（分发音频文件）并选择内容类型（Announcement（公告）、Advertisement（广告）或 Music（音乐））。

2. 单击 Files（文件）旁边的 + Add（添加）。

3. 选择要分发的文件，然后单击 Open（打开）。

4. 单击位于Audio sites（音频场所）旁边的+ Add（+ 添加）。

5. 在音频场所结构中选择位置。

   内容将分发至位置中的大多数场所，包括子位置中的音频场所。

6. 单击 Distribute audio files（分发音频文件）。

借助 AXIS Audio Manager Center 您可以一次将通知、广告和音乐安排到多个音频场所。当您创建时间表时，您可通过选择位置来定位音频场所。该地点及其大多数子地点中的大多数音频场所都包括在内。您还可以选择标签以进一步过滤选区。

启用时间表后，只要该音频场所已连接，它就会自动应用于时间表中包含的音频场所。如果某个音频场所未连接，则将在其连接后立即应用时间表。

如果已启用时间表，它将自动包括添加到所选位置或其子位置的新音频场所，或者是否有更多的音频场所应用所选标签。

AXIS Audio Manager Center 还会将执行时间表所需的媒体内容分配到大多数目标音频场所。使用本地库或来源标签创建的音乐时间表例外。

当您排定相对于打开时间的日程时，存在事件设置为在当天（0–24）以外播放的风险。此音频将无法播放。例如，如果您安排通知在结束时间后 5 小时播放，而结束时间是晚上 9 点，则事件将安排在第二天凌晨 2 点，因此不会播放。

了解更多：

• 标签

• 源标签

• 位置

1. 创建一个时间表：

2. 1. 转到预置 > 预置。

   2. 单击 + 创建时间表。

   3. 命名日程表。

   4. 在预置类型下，选择通知。

   5. 选择位置。

      有关详细信息，请参见 位置。

   6. 单击 CREATE（创建）。

3. 要查看您的音频场所列表，请转到AUDIO SITES（音频场所）。

4. 要上传音频文件并创建播放列表，请转到内容。

5. 配置时间表：

6. 1. 转到时间表。

   2. 单击 + 事件并选择单个事件或事件。

   3. 填写详细信息，然后单击保存。

   4. 要启用时间表，请在时间表状态下选择已启用。

7. 预览时间表：

8. 1. 在Preview schedule（预览时间表）下，选择开放时间或音频场所。

      如果在选定的开放时间内不播放，则该活动将变为灰色。

9. 要保存您对时间表所做的更改，请单击保存。

广告预置可用于应在特定时间段内重复播放的内容。

1. 创建一个时间表：

2. 1. 转到预置 > 预置。

   2. 单击 + 创建时间表。

   3. 命名日程表。

   4. 在预置类型下，选择广告。

   5. 选择位置。

      有关详细信息，请参见 位置。

   6. 单击 CREATE（创建）。

3. 要查看您的音频场所列表，请转到AUDIO SITES（音频场所）。

4. 要上传音频文件并创建播放列表，请转到内容。

5. 配置时间表：

6. 1. 转到时间表。

   2. 单击 + 事件并选择单个事件或事件。

   3. 填写详细信息，然后单击保存。

   4. 要启用时间表，请在时间表状态下选择已启用。

7. 预览时间表：

8. 1. 在Preview schedule（预览时间表）下，选择开放时间或音频场所。

      如果在选定的开放时间内不播放，则该活动将变为灰色。

9. 要保存您对时间表所做的更改，请单击保存。

您可以创建背景音乐时间表，以相对于音频场所的开始时间的偏移开始和结束。

有关详细信息，请参见 起始和结束偏移。

• 支持的音乐源：

• 每个音频场所的本地库。

• 从 AXIS Audio Manager Center 分配的网络流。

  有关详细信息，请参见 Audio Manager Center Source。

• 针对本地音频场所来源的源标签，如线路输入和板载应用。

  有关详细信息，请参见 源标签。

• 前提条件：

• 相对于本地音频场所的上班时间应用音乐计划。

  要设置本地音频场所的开放时间，请参阅 AXIS Audio Manager Edge 用户手册中的设置开放时间。

1. 使用网页流来源：

2. 1. 转到预置 > 来源，然后单击 + 创建源。

   2. 命名该源。

   3. 该类型当前限制为已预先选择的网页流。

   4. 输入网页流的 URL。

   5. 如果 URL 需要身份验证，请激活使用身份验证 并输入用户名和密码。

   6. 单击 CREATE（创建）。

3. 创建一个时间表：

4. 1. 转到预置 > 预置，然后单击 + 创建时间表。

   2. 命名日程表。

   3. 在Type of schedule（时间表类型）下，选择Music（音乐）。

   4. 选择位置。

      有关详细信息，请参见 位置。

   5. 单击 CREATE（创建）。

5. 要查看全部目标音频场所，请转到AUDIO SITES（音频场所）。

6. 配置时间表：

7. 1. 转到时间表。

   2. 如果不想让安排的音乐自动开始播放，而是等待有人从AXIS Audio Manager Edge的仪表板上、使用AXIS Remote移动应用程序或使用AXIS C8310 Volume Controller在本地开始播放音乐，请选择Require manual source selection locally before playback start（开始播放前需要在本地手动选择来源）。

   3. 在预置时间下，设置相对于开始和关闭时间的偏离时间。

      有关详细信息，请参见 起始和结束偏移。

   4. 添加音乐来源。

   5. 1. 点击添加音乐来源

      2. 选择来源类型：

      3. • Audio Manager Center Source

           有关详细信息，请参见 Audio Manager Center Source。

         • 源标记

           有关详细信息，请参见 源标签。

         • 本地库

      4. 单击添加。

   6. 注意

      您可以将多个来源添加到音乐时间表中。如果用户使用的是AXIS OS 11.6或更高版本的主机设备，则可以从AXIS Audio Manager Edge中的仪表板本地切换来源。对于较早的AXIS OS版本，将仅播放列表中的首个来源。

   7. 保存时间表：

   8. • 如果要保存时间表而不激活，请清除已启用复选框，然后单击 保存。

        时间表现在已保存并在您的音乐时间表列表中可用，但尚未启用。

      • 如果要保存时间表并将其激活，请选择已启用复选框，然后单击保存并发布。

        现在，您的音乐时间表列表中提供了时间表，并已启用，这意味着它将被分发至大多数目标音频场所。

      • 注意

        请注意，这将覆盖本地音乐时间表。

通过使用 AXIS Audio Manager 移动应用程序，您可以从智能手机对音频场所内的一台或多台设备进行远程寻呼。

要使用移动应用程序进行远程寻呼，首先需要在 AXIS Audio Manager Center 中创建一个寻呼接受者和一个具有寻呼操作权限的用户组。

• 可从 AXIS Audio Manager Center 配置两种类型的 SIP 寻呼：

• 单向寻呼 ：用于向一个音频场所的一台或多台设备发送音频消息，但不接收音频消息。单向寻呼接受者将显示在移动应用程序中的 Callout（喊话）选项卡上。您既可以发送实时音频消息，也可以发送预录制的音频消息。

• 双向寻呼：通过一个音频场所的单一设备进行实时双向通信。双向寻呼将出现在移动应用程序中的 Call（呼叫）选项卡上。

1. 创建一个寻呼接受者：

2. 1. 在 Location（位置）下，选择要创建寻呼接受者的音频场所。

   2. 单击 + CREATE（创建）。

   3. 为接受者命名。

   4. 在 Type（类型）下，选择 One-way（单向）或 Two-way（双向）。

   5. 注意

      我们建议您先创建双向接受者，再创建单向接受者。

   6. 单击 Create（创建）。

   7. 对于单向寻呼，添加目标物理区域和设备。

      对于双向寻呼，选择要通过其进行通信的设备。

   8. 单击 Create（创建）。

   9. 等待直至 Status（状态）下显示 OK。

      如果收到的是 Error ，请单击 > Verify configuration（确认配置）进行调查。

   10. 单击 > Ports（端口），保障您使用了正确的 SIP 端口。

   11. 单击 > Volume（音量），保障音量水平正常。

3. 赋予用户寻呼权限：

4. 1. 转到用户管理。

   2. 单击 + 创建用户组。

   3. 命名用户组。

   4. 在用户角色下，选择寻呼操作员。

   5. 单击 Create（创建）。

   6. 添加位置和成员。

   7. 点击关闭。

位置是音频场所结构中的一个节点。有关详细信息，请参见 为您的音频场所创建结构。

当在 AXIS Audio Manager Center 中预置内容时，您必须首先选择分发时间表的位置。该位置及其子位置的大多数音频场所均可用于时间表。

标签用于向可在 AXIS Audio Manager Center 中筛选或搜索的音频场所添加标识符。

• 您可以筛选和搜索Audio sites（音频场所）视图中的标签，以便更容易地查找场所。

• 您可以将标签包含在 AXIS Audio Manager Center 时间表中，以进一步过滤选区，以仅将具有该标签的场所作为属性包括在内。

将相对于每个本地音频场所的上班时间来创建时间表。当批处理时间表配置针对的音频场所具有不同的起始时间时，这可解决问题。起始偏移决定音乐何时开始播放以及音乐停止播放时的结束偏移。

Audio Manager Center 源是在预置 > 音乐 > 源下创建的来源。它会自动分配给组织中的大多数音频场所。来源通过AXIS Audio Manager Center集中管理。目前，仅支持 web 流源。

如果您计划在 AXIS Audio Manager Center 时间表中使用 Axis Audio Manager Edge 音频场所的本地资源，则您必须在每个 AXIS Audio Manager Edge 音频场所中为这些来源分配一个源标签。在 AXIS Audio Manager Center 中创建源标签，并将其分配给组织中的大多数连接的音频场所。要在本地音频场所中使用源标签配置源，请转到  AXIS Audio Manager Edge >  SCHEDULING（计划）> Music（音乐）> SOURCES（源），选择正确的源并分配一个源标签。然后，可通过 AXIS Audio Manager Center 分配的时间表来使用此来源。

• 必须在本地定义的源示例：

• 线路输入

• 播放列表

• ACAP

• 少有的网页流 URL（即 URL 在每个音频场所中是少有的）

示例：一个企业购买了一种在线流传输音乐服务，它使用已安装的 ACAP 来提供服务。它们在 Axis Audio Manager Center 创建一个源标签“ACAP流传输”。然后，拥有 ACAP 音乐源的每个音频场所都必须将其分配给源标签 “ACAP 流”，以允许从 Axis Audio Manager Center 安排此来源。在创建时间表时，他们助力使用位置和标签对正确的音频场所进行了定向，然后它们将设置所需的打开/关闭偏移，之后选择带有标记“ACAP流传输”的音乐源“源标签”。目标音频场所现已通过流传输音乐服务播放音乐的音乐时间表。

您可以通过 webhook 接收来自 AXIS Audio Manager Center 的系统事件。事件以 HTTP POST 请求的形式交付。

在向消费者发送事件之前，必须完成验证握手。配置 Webhook 时，发送者会发出预检请求以验证目标端点。如果消费者未对此请求作出适当响应，则订阅将不会建立。

为接受大多数 webhook 事件的发起者，需对 OPTIONS 请求返回 200 OK 状态码，并包含以下标题： Webhook-Allowed-Origin: '*'

仅接受我们作为发起者时，请返回 200 OK 状态码，并包含来自 Webhook-Request-Origin 标题的确切来源。

为符合 CloudEvents 规范，webhook 接收器必须返回成功的 HTTP 状态码，例如 200 OK、201 Created、202 Accepted 或 204 No Content。不允许且不会遵循重定向响应 (3xx)。

若接收器暂时过载，应返回 429 Too Many Requests。若该端点已被永久停用，则应返回 410 Gone，此操作将禁用订阅并停止事件交付。

大多数 webhook 事件均遵循以下结构：

{
  "specversion": "1.0",
  "id": "<event-id>",
  "source": "com.axis.audiomanager",
  "type": "<event-type>",
  "time": "<timestamp>",
  "eventversion": "1",
  "eventcorrelationid": "<correlation-id>",
  "datacontenttype": "application/json",
  "dataschema": "com/axis/one/notification-service/webhook/@v/1.0.0",
  "data": {
    "data": { <event-specific data> },
    "datacontenttype": "application/json",
    "dataschema": "<event-specific schema>"
  }
}

1. Webhook 事件分为三种类型：

2. Audio site events（音频场所事件） — 音频场所状态变更。

3. • 类型：com.axis.audiomanager.status.site

   • 模式：com/axis/audiomanager/status/site/@v/1.0.0

   • data.data 中的字段：

   • • siteName - 音频场所的名称。

     • siteId - 音频场所的ID。

     • siteLocationNames – 音频场所的位置路径。

     • statusSeverity – 高级音频场所状态。

     • statusType - 音频场所状态子类别。

     • organizationName - 企业的名称。

     • organizationId – 企业的 ID。

     • aamcUrl – 链接至 AXIS Audio Manager Center 中的事件日志。

4. 计划事件 — 企业中的时间表的状态变更。

5. • 类型：com.axis.audiomanager.status.schedule

   • 模式：com/axis/audiomanager/status/schedule/@v/1.0.0

   • data.data 中的字段：

   • • scheduleName - 时间表的名称。

     • scheduleId - 时间表的 ID。

     • statusSeverity – 高级时间表状态。

     • statusType – 时间表状态子类别。

     • siteName – 触发该事件的场所名称。

     • siteId - 音频场所的ID。

     • siteLocationNames – 音频场所的位置路径。

     • organizationName - 企业的名称。

     • organizationId – 企业的 ID。

     • aamcUrl – 链接至 AXIS Audio Manager Center 中的事件日志。

6. 寻呼接受者事件 — 音频场所上各个寻呼接受者的状态更新。

7. • 类型：com.axis.audiomanager.status.paging

   • 模式：com/axis/audiomanager/status/paging/@v/1.0.0

   • data.data 中的字段：

   • • pagingRecipientName – 寻呼接受者的姓名。

     • pagingRecipientId – 寻呼接受者的 ID。

     • statusSeverity – 高级寻呼接受者状态。

     • statusType – 寻呼接受者子类别

     • siteName – 寻呼接受者所在场所的名称。

     • siteId – 寻呼接受者所在场所的 ID。

     • siteLocationNames – 音频场所的位置路径。

     • organizationName – 企业的名称。

     • organizationId – 企业的 ID。

     • aamcUrl – 链接至 AXIS Audio Manager Center 中的事件日志。

配置 Webhook 时，您可同时输入 Webhook 密钥和目标 URL。该密钥用于验证传入的 Webhook 请求是否真实且未被篡改。

1. 工作原理：

2. 发送者使用您配置的私有签名密钥对事件有效载荷生成 HMAC-SHA256 签名。

3. 签名包含在请求的 webhook-signature-sha256 标题中。

4. 在服务器上，使用接收到的有效载荷和您的私有签名密钥重新计算 HMAC。

5. 将其与提供的签名进行比较。

6. 如果匹配成功，则请求通过验证。

Webhook 私有签名密钥的要求：

• 在 AXIS Audio Manager Center 中配置 webhook URL 时，必须输入私有签名密钥。

• 私有签名密钥必须是长度不超过 1024 个字符的十六进制字符串。

• 私有签名密钥的字符数必须为偶数。

• 必须在您的服务器上使用相同的密钥来验证传入请求。

• 有效私有签名密钥的正则表达式：^([0-9a-fA-F]{2}){0,512}$

此示例演示了 Webhook 接收器实现的基本原理，仅用于教学目的。生产环境的实现必须包含适当的安全强化措施、验证机制和错误处理。

1. 创建新的 AWS Lambda 函数：

2. 1. 续航时间：Node.js 22 或更高

   2. 架构：X86_64

   3. 函数 URL：已启用（身份验证类型 NONE）

3. 插入并部署代码。

4. 在 AXIS Audio Manager Center中设置新的 webhook：

5. 1. 使用您的公共 Lambda 函数 URL。

   2. 使用您的私有签名密钥（示例代码中为：4d79207365637265742070617373706872617365）。

   3. 选择要使用的触发器（例如音频场所事件）和位置（例如企业级别）。

6. 触发测试事件（例如，重启音频场所主设备以生成断开连接事件）

7. 检查您的 Lambda 日志。

import { createHmac, timingSafeEqual } from "crypto";

const passphrase = "My secret passphrase";
// Resulting secret signing key (hex): 4d79207365637265742070617373706872617365
const secretSigningKey = Buffer.from(passphrase, "utf-8").toString("hex");

const verifySignature = (event) => {
  try {
    const signature = event.headers["webhook-signature-sha256"];
    const signatureBuffer = Buffer.from(signature, "hex");
    const signingKeyBuffer = Buffer.from(secretSigningKey, "hex");
    const bodyBuffer = Buffer.from(event.body, "utf-8");
    const hmacDigest = createHmac("sha256", signingKeyBuffer).update(bodyBuffer).digest();

    return timingSafeEqual(hmacDigest, signatureBuffer);
  } catch (error) {
    console.error("Failed to verify signature:", error);
    return false;
  }
};

const innerHandler = (event) => {
  // Handle the preflight request (required to verify receiver existence during setup)
  if (event.requestContext.http.method === "OPTIONS") {
    return {
      statusCode: 200,
      headers: { "Webhook-Allowed-Origin": event.headers["webhook-request-origin"] }
    };
  }

  if (!verifySignature(event)) {
    return { statusCode: 401, body: "Invalid signature" };
  }

  // Do business logic, e.g., store the event, send it to another service, etc.

  return { statusCode: 200, body: "Success" };
};

export const handler = async (event) => {
  console.log("Event:", event);
  const response = innerHandler(event);
  console.log("Response:", response);

  return response;
};

如果您需要更多帮助，请转到 axis.com/support。