マクロ

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

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

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

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

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

UI 拡張機能

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

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

オープン プラットフォームでは、既存のワークフローに添付するカスタマイズを作成できます。これにより、コアの Webex サービスを超える付加価値を生み出すことができます。

次のような例があります。

  • メイン画面でカスタムウェブサーバのデータを表示しています。

  • チケットシステムへの問題のレポート。

  • 会議室の音響データを収集し、それをウェブサーバに送信して描画する。

  • 照明、ブラインド、ビデオスイッチャーなど、サードパーティの周辺機器を操作する。

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

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

マクロのプロビジョニングを有効にするには、 端末 > 設定 > マクロ Control Hub で Control Hub にマクロの管理を許可する をオンに切り替えます。


  • Control Hub のすべてのマクロは Cisco クラウドで保存および暗号化されますが、顧客所有の秘密鍵は使用されません。 マクロに機密データが含まれている場合は、Control Hub のマクロ プロビジョニングを有効にしないでください。

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


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

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

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

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

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


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

ここでは、次の操作が可能です。

  • マクロを作成、編集、削除します。

  • マクロ (*.js) のアップロードとダウンロード。

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

  • 変更を保存します。

  • マクロ ログを表示する。


誰かが別のウェブ上の場所から同じマクロを同時に編集している場合、あなたのバージョンのコピーをダウンロードするか、あなたのバージョンを破棄するか、他のバージョンに上書きするかを選択するオプションが表示されます。

マクロエディタ には、コードエディタ、ログツール、マクロを素早くテストするためのコントロールが用意されています。


マクロエディタ

管理者 資格情報を使用して端末のウェブインターフェースにサインインし、 カスタマイズ > マクロエディタ。 ここでは、次の操作が可能です。

  • マクロを作成、編集、削除します。

  • マクロ (*.js) をインポートまたはエクスポートします。

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

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

  • 変更を保存します (Ctrl+S)


    誰かが別のウェブ上の場所から同じマクロを同時に編集している場合、あなたのバージョンのコピーをダウンロードするか、編集を破棄するか、他のバージョンに上書きするかを選択するオプションが表示されます。

UI 拡張機能エディタ には、以下を作成するためのツールが用意されています。

  • アクションボタン - ホームページに追加されるボタンです。 アクションボタンは、ユーザがタップしたときにアクションを実行するようにプログラムできます。

  • パネル - コントロール パネルには、アクションを実行するようにプログラムできる多くの UI 要素 (例えば、ボタン、テキスト フィールド、スイッチ、スライダー) を含めることができます。 これにより、共通の場所で独自のコントロール グループを組み合わせることができます。

  • ウェブ アプリ – ホームページに追加されるウェブ アプリのショートカット。 ウェブ アプリは、事前に定義されたウェブ ページをフルスクリーンで起動します。 これは、ウェブ エンジンを持つすべてのデバイスで利用できます (DX を除く、Board および Desk シリーズ デバイス)。

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


UI 拡張エディタ(UI Extensions Editor)

ここでは、次の操作が可能です。

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

  • 多くのタイプのコントロールを作成および構成する。

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

  • UI 拡張機能が表示されるタイミングを定義します。

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

UI 拡張機能をマクロに接続するには、固有の ID を選択します。 たとえば、トグルの ID は「lights_on」である可能性があります。 次に、画面のタップを監視し、「ライト オン」ボタンがタップされたことを検出すると、目的のコマンドを発行するマクロを作成します (ライトのオン/オフなど)。

UI 拡張機能をマクロに接続する例については、 ここに

マクロの作成と UI 拡張機能の詳細については、次を参照してください。

[ Cisco Collaboration Developer コミュニティ マクロおよびサードパーティ コードに関するヘルプが必要な場合。

参照先 会議室、卓上デバイス、および Webex ボードのデバイス設定 ローカルウェブインタフェースへのアクセス方法についての詳細。