AXIS Audio Manager Center

AXIS Audio Manager Centerは、大規模で複雑な音声システムをリモートで管理および監視するための、セキュアで拡張性に優れたソリューションです。

• サイトを整理する — 組織に適した構造でAXIS Audio Manager Edgeサイトを整理できます。

例

「France」という名前のロケーションに、「Paris」という名前のロケーションを含めたとします。そのロケーションには、Parisにあるすべてのサイトが含まれることになります。

例

「Sales region South」という名前のロケーションに、その地域に属するすべての都市を含めたとします。そのロケーションには、それらの都市にあるすべてのサイトが含まれることになります。

• システムを監視する - [Dashboard (ダッシュボード)] ビューと [Sites (サイト)] ビューには、システムの概要が表示されます。フィルタリング機能でトラブルシューティングも簡単。

• サイトにリモートでアクセスする - [Sites (サイト)] ビューからセキュアな方法でサイトのユーザーインターフェースにリモートでアクセスします。

• ユーザーを管理する - ユーザーを招待し、各ユーザーを1つまたは複数のユーザーグループに追加します。各ユーザーグループには特定のアクセス権が付与され、サイト構造内のロケーションやサイトが割り当てられます。

例

1人のユーザーが、Europeのコンテンツ管理者権限を持つグループに属することも、さらにFranceのParis下のサイトの管理者権限を持つグループに属することもできます。

• プレミアム機能

• • スケジュール - 複数のサイトにアナウンス、広告、音楽をスケジュールします。

AXIS Audio Manager Centerの各リリースの新規機能については、help.axis.com/en-us/whats-new-in-axis-audio-manager-center を参照してください。

• 少なくとも1つの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	専用の装置通信チャンネル。これらのポートのいずれかを指定する必要があります。ポート80は、ポート443が使用できない場合にのみ使用されます。
  *.devices.audiomanager.axis.com	443 送信、TCP	専用の装置通信チャンネル。
  a1ecdk2dyb75d7-ats.iot.eu-west-1.amazonaws.com	8883 送信、TCP	装置からクラウドサービスにデータを送受信するために使用されるMQTTチャンネル。
  content.audiomanager.axis.com	443 送信、TCP	スケジュールにあるコンテンツ配信に必要です。

1. Webブラウザーでaudiomanager.axis.comに移動します。

2. My Axisアカウントの認証情報を使用してログインします。My Axisアカウントを持っていない場合は、ログインウィンドウから作成できます。

3. 初回のログイン時には、組織を作成する必要があります。

組織に招待されると、AXIS Audio Manager Centerから「User invitation to an organization (組織へのユーザー招待)」という件名で招待リンクが記載された電子メールが届きます。

1. 招待を承諾するには、記載されているリンクをクリックするか、ブラウザーに貼り付けます。

2. MyAxisアカウントの認証情報を使用してログインします。MyAxisアカウントを持っていない場合は、ログインウィンドウから作成できます。

3. 招待された組織に自動的に移動します。

組織内のサイトまたはサイトグループを簡単に見つけられるような構造にサイトを整理します。構造内のロケーションを選択することで、ユーザーグループを単一サイトまたはサイトのグループを割り当てることができます。詳細については、ユーザーを管理するを参照してください。

1. [Sites (サイト)] に移動します。

2. ロケーションを作成するには:

3. 1. 構造内の追加位置に移動します。

   2. [+ Create (作成)] をクリックします。

   3. ロケーションに名前を付け、[Create (作成)] をクリックします。

例

追加するサイトでAXIS Audio Manager Center統合を有効にします:

1. AXIS Audio Manager Edgeサイトにローカルでログインします。

2. [System settings (システム設定)] > [Connectivity (接続)] に移動します。

3. [AXIS Audio Manager Center integration (AXIS Audio Manager Center統合)] のチェックボックスをオンにします。

4. 必要に応じて、[AXIS Audio Manager Center O3C proxy (AXIS Audio Manager Center O3Cプロキシ)] を選択し、サイトがあるネットワークについて組織のプロキシの詳細を入力します。

5. [SAVE (保存)] をクリックします。

サイトをロケーションに追加する:

1. AXIS Audio Manager Centerで、[Sites (サイト)] に移動します。

2. 構造内のロケーションを選択します。

3. [+ ADD SITE (サイトを追加)] をクリックします。

4. サイト名、S/N (MACアドレス)、サイトのリーダーとして使用する装置のOAKキー (オーナー認証キー) を入力します。

   形式の例:
   - S/N: XXXXXXXXXXXX (12 digit hexadecimal)
   - OAK: XXXXXXXXXXXX (12 digit hexadecimal)

   OAKキーを見つけるには:

5. 1. AXIS Audio Manager Edgeサイトにローカルでログインします。

   2. [System settings (システム設定)] > [Leader device settings (リーダーデバイス設定)] に移動します。

   3. [Go to device settings (装置設定に移動)] をクリックします。

   4. [System (システム)] > [Network (ネットワーク)] に移動します。

   5. [One-click cloud connection (ワンクリッククラウド接続)] と [Owner authentication key (OAK) (オーナー認証キー (OAK))] で、[Get key (キーを取得)] をクリックします。

   6. 注

      S/N (MACアドレス)とOAKキー(オーナー認証キー)はいずれも、音声システムでリーダーとして使用されている製品に付属しているノートに記されています。

      ノートを紛失した場合は、Axisに連絡してください。新しいキーを受け取るには、所有権を証明する必要があります。

6. サイトの地理的位置を設定する:

7. 1. [Place site on map (地図上にサイトを配置)] を選択します。

   2. 検索に住所を入力すると、その場所にズームインします。

   3. マップをクリックして場所を追加します。

8. 後で場所を変更または削除するには、[Sites (サイト)] に移動し、サイトの行をクリックしてサイトの詳細を表示し、マップまで下にスクロールします。

1. [Sites (サイト)] に移動します。

2. サイトの詳細を表示するには、サイトの行をクリックします。

   マップ上のサイトをクリックすることもできます。

3. サイトの詳細を表示および編集する:

4. • AXIS OSのバージョン、シリアル番号、製品名など、リーダーデバイスに関する情報を検索します。

   • マップ上の地理的な場所を編集または削除します。

   • サイトの営業時間を表示または変更します。

   • トラブルシューティングのためにサーバーレポートファイルをダウンロードします。

AXIS Audio Manager Centerを使用するには、組織にユーザーとして登録されている必要があります。4つの既定のユーザーロールがあります。

• Owner (オーナー) - オーナーは組織のすべての設定と構成、すべてのロケーションとサイトに対する読み取り/書き込みのフルアクセス権を持つ、ユーザーロールと既定のユーザーグループです。オーナーは他のユーザーを管理し、アクセス権を割り当てる権限を持つ唯一のユーザーでもあります。組織の作成者は自動的にオーナーとして登録されます。

• 管理者 - 管理者は、自らのユーザーグループに割り当てられたロケーションとサイトに対する読み取り/書き込みアクセス権を持ちます。サイト構造内のロケーションが割り当てられている場合、そのロケーションの下に新しいロケーションとサイトを追加できます。

• コンテンツマネージャー - コンテンツマネージャーは、自らのユーザーグループに割り当てられたすべてのサイトにコンテンツ (音楽、広告、アナウンス) をアップロードし、スケジュールするアクセス権を持ちます。サイト構造内のロケーションが割り当てられている場合、そのロケーション下のすべてのサイトにアクセスできます。コンテンツマネージャーは、割り当てられたサイトの営業時間を設定し、音楽の音量を調整することもできます。

• Playback operator (再生オペレーター) - 再生オペレーターは、自分のユーザーグループに割り当てられているすべてのサイトの音楽の音量を設定することができます。サイト構造内のロケーションが割り当てられている場合、そのロケーション下のすべてのサイトにアクセスできます。

ユーザーの全アクセス権は、そのユーザーがどのユーザーグループに属するかによって決まります。各ユーザーグループにはユーザーロールが定義され、サイトが割り当てられています。1人のユーザーが複数のユーザーグループに属することができ、特定のサイトに対するアクセス権のうち最も高いアクセス権が適用されます。

例

あるユーザーが以下の2つのグループの両方に属しているとします。

• グループ : Content managers France

• • ユーザーロール: コンテンツ管理者

  • 所在地： フランス

• グループ : Administrators Paris

• • ユーザーロール: 管理者

  • 所在地：Paris (Franceのサブロケーション)

そのユーザーは、Parisのサイトを除くFranceのすべてのサイトに対してコンテンツ管理権限を持ち、Parisのサイトに対しては管理者権限を持ちます。これは、管理者権限がコンテンツ管理権限よりも上位にあるためです。ユーザーが複数のグループに属している場合、同じロケーションに複数のユーザーロールが適用される可能性があります。この場合、アクセス権が最上位のユーザーロールのみがそのロケーションに適用されます。

1. ユーザーを組織に招待する:

2. [User management (ユーザー管理)] に移動します。

3. 注

   オーナーのみ利用可能。

4. ユーザーグループを作成し、ユーザーロールおよびサイトに対するアクセス権を割り当てる:

5. 1. [CREATE (作成)] をクリックします。

   2. ユーザーグループに名前を付けます。

   3. ユーザーロールを選択します。

   4. [CREATE (作成)] をクリックします。

   5. [Location (ロケーション)] の横にある [Add (追加)] をクリックします。

   6. 特定のサイトにアクセスする場合は、サイトを選択します。ロケーション下のすべてのサイトにアクセスする場合は、ロケーションを選択します。

6. 新しいユーザーをユーザーグループに招待する:

7. 1. [Members (メンバー)] の横にある [Add (追加)] をクリックします。

   2. [INVITE USER (ユーザーの招待)] をクリックします。

   3. 招待するユーザーの電子メールアドレスを入力します。

      ユーザーグループはあらかじめ選択されています。

   4. 招待電子メールに含めるメッセージを書きます。

   5. [INVITE (招待)] をクリックします。

招待されたユーザーは、組織へのリンクが記載された電子メールを受け取ります。リンクをたどると、ログインするように求められ、その後、正しい組織に自動的にルーティングされます。1人のユーザーが複数の組織に属することができます。

1. 既存のユーザーをユーザーグループに追加する:

2. [User management (ユーザー管理)] に移動します。

3. ユーザーを追加するユーザーグループを選択します。

4. [Members (メンバー)] の横にある [Add (追加)] をクリックします。

5. リストでユーザーを見つけ、[ADD (追加)] をクリックします。

システムのステータスはダッシュボードから監視できます。ダッシュボードでは、サイトの接続ステータスや組織内のすべての装置の接続ステータスに関する情報を取得できます。この情報のほとんどは [Sites (サイト)] ビューでも参照できます。

1. [Dashboard (ダッシュボード)] に移動します。

2. サイトとスケジュールの状態を確認します。

3. サイトを調査する:

4. 1. [Sites (サイト)] に移動します。

   2. サイトリストの上にあるフィルターアイコンをクリックし、調査する問題を選択します。

      問題の各タイプの詳細については、トラブルシューティングを参照してください。

   3. サイトを調査するには、 > [Open AXIS Audio Manager Edge (AXIS Audio Manager Edgeを開く)] をクリックします。

5. スケジュールを調査する:

6. 1. [Scheduling (スケジューリング)] に移動します。

   2. スケジュールリストの上にあるフィルターアイコンをクリックし、調査する問題を選択します。

      問題の各タイプの詳細については、トラブルシューティングを参照してください。

   3. スケジュールを調査するには、リスト内の行をクリックします。

AXIS Audio Manager Centerは、サイトで発生するさまざまな種類のイベントについて、電子メールおよびWebhookで通知を送信できます。

通知を設定できるのは管理者のみです。組織を新規作成すると、Owner (オーナー) のロールが割り当てられます。通知を設定する前に、Administrator (管理者) ユーザーグループを設定し、自身をそのグループに追加する必要があります。

1. [Notifications (通知)] に移動します。

2. [+ Create (作成)] をクリックします。

3. 通知に名前を付けます。

4. [Email (電子メール)] を選択します。

5. [Next (次へ)] をクリックします。

6. 受信者の電子メールを入力します。

7. 通知トリガーを選択します。

8. [Create (作成)] をクリックします。

9. 受信者に確認リクエストを含む電子メールが送信されます。電子メールで[Confirm (確認)] をクリックすると、受信者への通知送信が開始されます。

10. ブラウザを更新し、通知のステータスが[Pending (保留)] から[OK] に変わったことを確認します。これは受信者が通知を確認したことを示しています。

1. [Notifications (通知)] に移動します。

2. [+ Create (作成)] をクリックします。

3. 通知に名前を付けます。

4. [Webhook] を選択します。

5. [Next (次へ)] をクリックします。

6. 受信者の詳細を入力します。

7. 通知トリガーを選択します。

8. ロケーションを選択するには、[+ Select (選択)] を選択します。

9. [Create (作成)] をクリックします。

AXIS Audio Manager Centerは、追加されたサイトへのセキュアリモートアクセスを提供します。 これにより、ローカルのAXIS Audio Manager Edgeシステムのリモートサイト設定が可能になります。サイトにアクセスするとき、ユーザーロールまたはユーザーグループの権限によって、リモートで可能になる操作が決まります。オーナーと管理者はサイトのすべての設定に対するフルアクセス権を持ちますが、コンテンツマネージャーと再生オペレーターはアクセス権が制限されます。

1. AXIS Audio Manager Edgeを開くには:

2. [Sites (サイト)] に移動し、お客様のサイトを見つけます。

3. > [Open AXIS Audio Manager Edge (AXIS Audio Manager Edgeを開く)] をクリックします。

AXIS Audio Manager Centerの設定が完了し、ユーザーに権限が割り当てられている場合、そのユーザーはiOSおよびAndroid向けのAXIS Audio Managerモバイルアプリを通じて音声システムにもアクセスすることができます。

このモバイルアプリで [Connect remotely (リモートで接続)] を選択することで、ユーザーはAXIS Audio Manager Centerにログインし、管理するサイトを選択することができます。

イベントログには、あなたが管理者である組織の中で発生したイベントが含まれます。

1. [Event log (イベントログ)] に移動します。

2. [Data selection (データの選択)] をクリックします。

3. タイムフレームを選択します。

4. • Relative (相対):現在からさかのぼってデータを取得する期間を選択します。

   • Absolute (絶対):データを取得する時間間隔を選択します。

5. フィルターを追加するには、[+ Filter (フィルター)] をクリックし、条件を選択します。

6. [Order (順序)] で、取得したデータの表示方法を選択します。

7. 取得したデータをCSVファイルにエクスポートするには、[Export (エクスポート)] をクリックします。

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. [Sites (サイト)] の横にある [+ Add (追加)] をクリックします。

5. サイト構造内のロケーションを選択します。

   コンテンツは、サブロケーションのサイトを含め、そのロケーション内のすべてのサイトに配信されます。

6. [Distribute audio files (音声ファイルの配布)] をクリックします。

AXIS Audio Manager Centerを使用すると、一度に複数のサイトにアナウンス、広告、音楽をスケジュールできます。スケジュールを作成するときは、ロケーションを選択することで対象サイトを指定します。そのロケーションとすべてのサブロケーションの全のサイトが含まれます。また、ラベルを選択して、選択内容をさらにフィルターすることもできます。

スケジュールは有効にすると、サイトが接続されている限り、スケジュールに含まれるサイトに自動的に適用されます。サイトが接続されていない場合は、接続されるとすぐにスケジュールが適用されます。

スケジュールが有効になっている場合、選択したロケーションまたはそのサブロケーションに新しいサイトが追加されたり、選択したラベルがさらに他のサイトに適用されたりした場合、それらのサイトは自動的にスケジュールに含まれます。

AXIS Audio Manager Centerは、スケジュールの実行に必要なメディアコンテンツもすべての対象サイトに配信します。ただし、ローカルライブラリやソースタグを使用して作成された音楽スケジュールは例外です。

営業時間に相対してスケジュールすると、イベントがその日の時間外 (0～24時外) に再生されるように設定されるリスクがあります。その場合、この音声は再生されません。たとえば、営業終了時間の5時間後にアナウンスを再生するようにスケジュールした場合、営業終了時間が午後9時であれば、そのイベントは翌日の午前2時にスケジュールされるため、再生されません。

詳細情報:

• ラベル

• ソースタグ

• 場所

1. スケジュールを作成する:

2. 1. [SCHEDULING > Scheduling (スケジューリング > スケジューリング)] に移動します。

   2. [+ CREATE SCHEDULE (+スケジュールの新規作成)] をクリックします。

   3. スケジュールに名前を付けます。

   4. [Type of schedule (スケジュール のタイプ)] で、[Announcement (アナウンス)] を選択します。

   5. ロケーションを選択します。

      詳細については、場所を参照してください。

   6. [CREATE (作成)] をクリックします。

3. サイトのリストを表示するには、[SITES (サイト)] に移動します。

4. 音声ファイルをアップロードしてプレイリストを作成するには、[CONTENT (コンテンツ)] に移動します。

5. スケジュールを設定する:

6. 1. [Schedules (スケジュール)] に移動します。

   2. [+ EVENT (+イベント)] をクリックし、[Single event (単一イベント)] または [Interval event (間隔イベント)] を選択します。

   3. 詳細を入力し、[SAVE (保存)] をクリックします。

   4. スケジュールを有効にするには、[Schedule status (スケジュールの状態)] で [Enabled (有効)] を選択します。

7. スケジュールをプレビューする:

8. 1. [Preview schedule (スケジュールをプレビュー)] で、営業時間またはサイトを選択します。

      選択した営業時間内に再生されないイベントはグレーになります。

9. スケジュールに加えた変更を保存するには、[SAVE (保存)] をクリックします。

広告のスケジュールは、一定の時間内に繰り返し再生する必要のあるコンテンツに使用できます。

1. スケジュールを作成する:

2. 1. [SCHEDULING > Scheduling (スケジューリング > スケジューリング)] に移動します。

   2. [+ CREATE SCHEDULE (+スケジュールの新規作成)] をクリックします。

   3. スケジュールに名前を付けます。

   4. [Type of schedule (スケジュール のタイプ)] の下で、[Advertisement (広告)] を選択します。

   5. ロケーションを選択します。

      詳細については、場所を参照してください。

   6. [CREATE (作成)] をクリックします。

3. サイトのリストを表示するには、[SITES (サイト)] に移動します。

4. 音声ファイルをアップロードしてプレイリストを作成するには、[CONTENT (コンテンツ)] に移動します。

5. スケジュールを設定する:

6. 1. [Schedules (スケジュール)] に移動します。

   2. [+ EVENT (+イベント)] をクリックし、[Single event (単一イベント)] または [Interval event (間隔イベント)] を選択します。

   3. 詳細を入力し、[SAVE (保存)] をクリックします。

   4. スケジュールを有効にするには、[Schedule status (スケジュールの状態)] で [Enabled (有効)] を選択します。

7. スケジュールをプレビューする:

8. 1. [Preview schedule (スケジュールをプレビュー)] で、営業時間またはサイトを選択します。

      選択した営業時間内に再生されないイベントはグレーになります。

9. スケジュールに加えた変更を保存するには、[SAVE (保存)] をクリックします。

BGMのスケジュールを作成するとき、音楽をサイトの営業開始時間のオフセットで開始し、営業終了時間のオフセットで終了するように設定できます。

詳細については、開始時間と終了時間に対するオフセットを参照してください。

• 対応している音楽ソース:

• 各サイトのローカルライブラリ。

• AXIS Audio Manager Centerから配信されるWebストリーム。

  詳細については、Audio Manager Centerのソースを参照してください。

• ローカルサイトのソース (ライン入力やオンボードアプリケーションなど) を対象にするソースタグ。

  詳細については、ソースタグを参照してください。

• 前提条件:

• 音楽スケジュールは、ローカルサイトの営業時間に関連して適用されます。

  ローカルサイトの営業時間を設定するには、AXIS Audio Manager Edgeユーザーマニュアルの「営業時間の設定」を参照してください。

1. Webストリームソースを使用するには:

2. 1. [SCHEDULING > Sources (スケジューリング > ソース)] に移動し、[+ CREATE SOURCE (ソースの新規作成)] をクリックします。

   2. ソースに名前を付けます。

   3. タイプは現在Webストリームに限定されており、あらかじめ選択されています。

   4. WebストリームのURLを入力します。

   5. URLに認証が必要な場合は、[Use authentication (認証を使用する)] を有効にし、ユーザー名とパスワードを入力します。

   6. [CREATE (作成)] をクリックします。

3. スケジュールを作成する:

4. 1. [SCHEDULING > Scheduling (スケジューリング > スケジューリング)] に移動し、[+ CREATE SCHEDULE (+スケジュールの新規作成)] をクリックします。

   2. スケジュールに名前を付けます。

   3. [Type of schedule (スケジュール のタイプ)]で[Music (音楽)]を選択します。

   4. ロケーションを選択します。

      詳細については、場所を参照してください。

   5. [CREATE (作成)] をクリックします。

5. すべての対象サイトを表示する場合は、[SITES (サイト)] に移動します。

6. スケジュールを設定する:

7. 1. [Schedules (スケジュール)] に移動します。

   2. スケジュールされた音楽を自動再生せず、AXIS Audio Manager Edgeのダッシュボード、AXIS Remoteモバイルアプリ、またはAXIS C8310 Volume Controllerを使用して、誰かがローカルで音楽を開始するのを待ちたい場合は、[Require manual source selection locally before playback start (再生を開始する前にローカルでソースを手動選択することを要求する)]を選択します。

   3. [Schedule time (スケジュール時間)] で、始業時間と終業時間に対するオフセットを設定します。

      詳細については、開始時間と終了時間に対するオフセットを参照してください。

   4. 音源を追加します。

   5. 1. [ADD MUSIC SOURCE (音源の追加)] をクリックします。

      2. ソースタイプの選択:

      3. • Audio Manager Centerのソース

           詳細については、Audio Manager Centerのソースを参照してください。

         • ソースタグ

           詳細については、ソースタグを参照してください。

         • 地域の図書館

      4. [ADD (追加)] をクリックします。

   6. 注

      音楽スケジュールには、複数のソースを追加できます。AXIS OS 11.6以降のホスト装置を使用している場合、ユーザーはAXIS Audio Manager Edgeのダッシュボードからローカルにソースを切り替えることができます。それより前のバージョンのAXIS OSでは、リスト内の最初のソースだけが再生されます。

   7. スケジュールを保存する:

   8. • スケジュールをアクティブにせずに保存する場合は、[Enabled (有効)] チェックボックスをオフにし、[Enabled (保存)] をクリックします。

        これでスケジュールは保存され、音楽スケジュールリストで使用可能になりますが、まだ有効にはなっていません。

      • スケジュールを保存してアクティブにする場合は、[Enabled (有効)] チェックボックスをオンにし、[Enabled (保存して公開)] をクリックします。

        スケジュールが [Music schedules (音楽スケジュール)] リストで使用可能になり、有効になります。これは、スケジュールがすべての対象サイトに配布されることを意味します。

      • 注

        これは、ローカルの音楽スケジュールよりも優先されることに注意してください。

AXIS Audio Managerモバイルアプリを使用すると、スマートフォンからサイト内の1台または複数のデバイスにリモートでページングできます。

リモートページングにモバイルアプリを使用するには、まずAXIS Audio Manager Centerでページング送信先とページングオペレーター権限を持つユーザーグループを作成する必要があります。

• AXIS Audio Manager Centerからは、次の2つのタイプのSIPページングを設定することができます。

• 単方向ページング: サイト内の1台または複数のデバイスへの音声メッセージ送信用 (受信は不可)。単方向ページングの送信先は、モバイルアプリの [Callout (単方向コミュニケーション)] タブに表示されます。ライブアナウンスと録音メッセージの両方を送信できます。

• 双方向ページング: サイト内のデバイス1台を介したライブ双方向コミュニケーション用。双方向ページングの送信先は、モバイルアプリの [Callout (双方向コミュニケーション)] タブに表示されます。

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. > [Port (ポート)] をクリックして正しいSIPポートを使用していることを確認します。

   11. > [Volume (音量)] をクリックし、音量が適切なレベルに調整されるようにします。

3. ユーザーにページング権限を付与する：

4. 1. [User management (ユーザー管理)] に移動します。

   2. [+ Create user group (ユーザーグループを作成)] をクリックします。

   3. ユーザーグループに名前を付けます。

   4. [User role (ユーザー役割)] で、[Paging operator (ページングオペレーター)] を選択します。

   5. [Create (作成)] をクリックします。

   6. ロケーションとメンバーを追加します。

   7. [閉じる] をクリックします。

ロケーションはサイト構造のノードです。詳細については、サイトの構造の作成を参照してください。

AXIS Audio Manager Centerでコンテンツをスケジュールするときは、まずスケジュールを配布するロケーションを選択する必要があります。ロケーションとそのサブロケーションのすべてのサイトがスケジュールの対象になります。

ラベルは、AXIS Audio Manager Centerでフィルターしたり検索したりできる識別子をサイトに追加するために使用します。

• [Sites (サイト)] ビューでラベルでフィルターしたり検索したりすることで、サイトを簡単に見つけることができます。

• AXIS Audio Manager Centerのスケジュールにラベルを含めることで、選択内容をさらにフィルターして、そのラベルを属性として持つサイトのみを対象にすることができます。

スケジュールは各ローカルサイトの営業時間に相対して作成されます。これにより、バッチスケジュール設定の対象サイト間で営業時間が異なる場合の問題が解決します。開始時間に対するオフセットにより音楽の再生を開始するタイミングが決まり、終了時間に対するオフセットにより音楽の再生を停止するタイミングが決まります。

Audio Manager Center Source (Audio Manager Centerのソース) は、[SCHEDULING (スケジュール)] > [Music (音楽)] > [Sources (ソース)] で作成されるソースです。このソースは組織内のすべてのサイトに自動的に配信されます。ソースはAXIS Audio Manager Centerで一元管理されます。現在、Webストリームソースにのみ対応しています。

AXIS Audio Manager CenterのスケジュールでAxis Audio Manager Edgeサイトのローカルソースを使用する予定の場合は、各ローカルサイトでこれらのソースにソースタグを割り当てる必要があります。ソースタグはAXIS Audio Manager Centerで作成し、組織内のすべての接続サイトに配布されます。ローカルサイトのソースにソースタグを設定するには、[AXIS Audio Manager Edge] > [SCHEDULING (スケジュール)]> [Music (音楽)] > [SOURCES (ソース)]に移動し、正しいソースを選択し、ソースタグを割り当てます。このソースはAXIS Audio Manager Centerによって配布されるスケジュールで使用できます。

• ローカルで定義する必要があるソースの例:

• ライン入力

• 再生リスト

• ACAP

• 一意のWebストリームのURL (URLは各サイトに固有のものとする)

例：ある組織が、オンライン音楽ストリーミングサービスを購入して、インストールされたACAPを使用してそのサービスを提供するとします。その組織で、Axis Audio Manager Centerで「ACAP streaming」というソースタグを作成します。ACAP音楽ソースのある各サイトでは、このソースをAxis Audio Manager Centerからスケジュールできるように、そのソースにソースタグ「ACAP streaming」を割り当てる必要があります。スケジュールを作成するときには、ロケーションとラベルを使用して正しいサイトが対象になっていることを確認します。その後、開始/終了時間に対する必要なオフセットを設定し、最後に [ACAP streaming] タグが付いた音楽ソース [Source tag] を選択します。これで対象サイトでは、音楽ストリーミングサービス経由で音楽を再生する音楽スケジュールが設定されました。

AXIS Audio Manager CenterからWebhook経由でシステムイベントを受信できます。イベントはHTTP POSTリクエストとして配信されます。

イベントを消費者に送信する前に、検証ハンドシェイクを完了する必要があります。Webhookが設定されると、送信元がターゲットエンドポイントを検証するためにプリフライトリクエストを発行します。消費者がこのリクエストに適切に応答しない場合、サブスクリプションは確立されません。

Webhookイベントのすべての発行者を承諾するには、OPTIONSリクエストに200 OKステータスで応答し、以下のヘッダーを含めます。Webhook-Allowed-Origin: '*'

発行者として当社のみを承諾するには、200 OKで応答し、Webhook-Request-Originヘッダーに記載された正確なオリジンを含めます。

CloudEvents仕様に準拠するため、Webhookレシーバーは200 OK、201 Created、202 Accepted、または204 No Contentなどの成功したHTTPステータスで応答する必要があります。リダイレクト応答 (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イベントは以下の3種類です。

2. 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. Scheduled events (スケジュール済みのイベント) — 組織のスケジュールのステータスの変更。

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. Paging recipient events (ページング送信先イベント) — サイトの個々のページング送信先に関するステータス更新。

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 – 組織のID。

     • organizationId – 組織のID。

     • aamcUrl – AXIS Audio Manager Centerのイベントログへのリンク。

Webhookの設定時に宛先URLとともにWebhookの秘密の情報を入力できます。この秘密の情報は、受信するWebhookリクエストが真正であり、改ざんされていないことを確認するために使用されます。

1. 仕組み：

2. 送信者が設定済みの秘密署名鍵を使用して、イベントペイロードのHMAC-SHA256署名を作成します。

3. この署名がリクエストのwebhook-signature-sha256ヘッダーに含まれます。

4. サーバーで、受信したペイロードと秘密署名鍵を使用してHMACを再計算します。

5. 提供された署名とそれを比較します。

6. 一致する場合、リクエストの真正性が確認されます。

Webhook秘密署名鍵の要件:

• AXIS Audio Manager CenterでWebhook URLを設定する際に秘密署名鍵を入力すること。

• 秘密署名鍵は16進数文字列で最大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にアクセスしてください。