マクロ

マクロは、デバイス上でローカルで実行される小さな JavaScript プログラムです。たとえば、デバイスをプログラムして、特定の番号からの着信に自動的に応答することができます。

マクロは、デバイスおよびサードパーティのシステムに対して、アプリケーションプログラミングインターフェイス(API)コマンドを実行できます。

すべてのアクティブなマクロは、ランタイムと呼ばれるデバイス上で単一のプロセスで実行されています。デバイスの Web インターフェイスから、必要に応じてランタイムを開始および停止できます。ランタイムはサンドボックスで、コードはデバイスの標準ソフトウェアから安全に切り離されています。

デバイスの Web インターフェイスで、Control Hub またはマクロ エディタ からマクロを管理できます。Control Hub からマクロを設定するには、まずデバイスのマクロ プロビジョニングを有効にする必要があります。

Control Hub では、デバイスの履歴でマクロに加えられた変更を確認できます。

UI 拡張機能

UI 拡張機能は、自分自身で作成し、デバイスのタッチ スクリーンに追加するカスタム ボタンまたはパネルです。たとえば、「クイック ダイヤル」ボタンを追加して、頻繁に使用する番号に発信するか、または特定の番号からの通話に自動的に応答するためにデバイスをプログラムします。

UI 拡張機能は、ライト、ブラインド、ビデオ スイッチなど、サードパーティの周辺機器をコントロールすることもできます。ビデオ デバイスと周辺機器が同じユーザー インターフェイスから制御されている場合、デバイス デバイスで一貫したユーザー エクスペリエンス会議室。サードパーティのコントロール システムとの通信は、サードパーティ API を通じて行われます。

オープンプラットフォームを使用すると、既存のワークフローに関連するカスタマイズを作成することができます。つまり、Webexの中核を超えた新しい価値を提供できます。

いくつかの例には、次のものが含まれます。

  • メイン画面にカスタムWebサーバーデータを表示します。

  • 問題をチケットシステムに報告する。

  • 部屋から音響データを収集し、それを取り扱う Web サーバーに送信します。

  • ライト、ブラインド、ビデオ スイッチなど、サードパーティの周辺機器をコントロールします。

デバイスの Web インターフェイスの UI 拡張機能エディタ から UI 拡張機能を作成できます。

マクロ プロビジョニングを有効にすると、Control Hub からデバイスごとにマクロへの読み取りと書き込みアクセスができます。有効にすると、共有モードで登録されているすべてのデバイスは、マクロを Control Hub にアップロードします。管理者は、マクロのソース コードを編集したり、ローカル コピーをダウンロードしたり、他のデバイスにマクロをアップロードしたりできます。

マクロ プロビジョニングを有効にするには、Control Hub の [デバイス] > [設定] > [マクロ] に進み、[Control Hub にマクロの管理を許可] をオンに切り替えます。


  • Control Hub のすべてのマクロは保存され、暗号化されますが、Cisco Cloud で顧客のプライベート キーを使用することはできません。マクロに機密データが含まれている場合は、Control Hub のマクロ プロビジョニングを有効にしないでください。

  • マクロの Control Hub プロビジョニングは、共有モード デバイスにのみ適用されます。


先に上記の説明に従って、Control Hub のマクロのプロビジョニングを有効にする必要があります。

マクロ プロビジョニングは、単一デバイスで提供されます。デバイス間でマクロを共有するには、あるデバイスからマクロをダウンロードし、別のデバイスにアップロードします。

共有モードデバイスのマクロにアクセスするには:

  1. https://admin.webex.com の顧客ビューから、[デバイス] に移動し、設定するデバイスを選択します。

  2. [構成] に移動し、[マクロ] を選択します。


Control Hub デバイス マクロ パネル

ここから、次の方法で行います。

  • マクロの作成、編集、および削除。

  • マクロをアップロードおよびダウンロード (*.js)。

  • マクロを有効または無効にします。

  • 変更を保存します。

  • マクロ ログを表示します。


誰かが別の Web ロケーションから同じマクロを同時に編集した場合、バージョンのコピーをダウンロードしたり、バージョンを破棄したり、他のバージョンを上書きしたりするためのオプションが表示されます。

マクロ エディタは、 コードエディタ、ログツール、マクロの迅速なテストのためのコントロールを提供します。


マクロエディタ

管理者 資格情報を使用してデバイスの Web インターフェイスにサインインし、[カスタマイズ] > [マクロ エディタ] に移動します。ここから、次の方法で行います。

  • マクロの作成、編集、および削除。

  • マクロ (*.js) のインポートまたはエクスポート

  • マクロを有効または無効にします。

  • デバッグログを確認します。

  • 変更を保存 (Ctrl+S)


    別の Web ロケーションから同じマクロを同時に編集した場合、バージョンのコピーをダウンロードするか、編集を破棄するか、別のバージョンを上書きするオプションが提示されます。

UI 拡張機能エディターは、次の 作成のためのツールを提供します。

  • アクションボタン - ホームページにボタンが追加されました。ユーザーがタップした時にアクションを実行するためのアクションボタンを設定できます。

  • パネル - コントロール パネルユーザーは、多くの UI 要素 (ボタン、テキストフィールド、スイッチ、スライダなど) を含む可能性があります。これらの要素はすべてアクションを実行するためにプログラムできます。これにより、共通の場所に独自のコントロール グループを組み合わせできます。

  • ウェブ アプリ – ホーム ページに追加されたウェブ アプリのショートカット。ウェブ アプリはウェブ アプリのサイトで事前に定義された全画面。これはウェブ エンジン付きすべてのデバイス (DX を除く、Board および Desk シリーズ) で使用可能です。

管理、RoomControl、または インテグレータ の資格情報を使用してデバイスの Web インターフェイスにサインインし、[カスタマイズ] > [UI 拡張機能エディタ] に移動します。


UI 拡張機能エディタ

ここから、次の方法で行います。

  • UI 拡張機能の追加、アップロード、ダウンロード、または削除。

  • 多くのタイプのコントロールを作成し、構成します。

  • UI 拡張をアクティブ対 非アクティブ に設定します。

  • UI 拡張機能が表示される時間を定義します。

  • UI 拡張をビデオ デバイスまたはコンピューターのファイルにエクスポートします。

UI 拡張機能をマクロに接続するには、項目に固有の ID を 使用する 必要があります。たとえば、トグルの ID は「」である場合がありますlights_on。lights_on次に、画面をタップして監視するマクロを書き込み、[] ボタンがタップされたと検出すると、希望のコマンドを発行します (ライトのオン/オフなど)。

UI 拡張機能をマクロに接続する例については、こちらを参照してください。

マクロおよび UI 拡張の作成についての詳細:

マクロおよび サードパーティコードのヘルプが 必要な場合は、Cisco Collaboration Developer コミュニティにアクセスしてください。

ローカル Web インターフェイスにアクセスする方法に関する情報については、「Room および Desk デバイスWebex Boardsデバイス設定」を参照してください。