マクロ

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

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

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

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

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

UI 拡張機能

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

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

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

例としては次のようなものがあります。

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

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

  • 部屋から音響データを収集し、それをプロットできる Web サーバに送信します。

  • ライト、ブラインド、ビデオ スイッチャーなどのサードパーティ製周辺機器の制御。

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

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

マクロ プロビジョニングを有効にするには、 デバイス > 設定 > マクロ に移動します。Control Hub で Control Hub によるマクロの管理を許可しますをオンにします。


  • すべてのマクロは Cisco クラウドに保存され、暗号化されることに注意してください。 マクロに機密データが含まれている場合は、Control Hub マクロ プロビジョニングを有効にしないでください。

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


前述のように、まず Control Hub のマクロのプロビジョニングを有効にする必要があります。

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

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

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

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


コントロール ハブ デバイス マクロ パネル

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

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

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

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

  • 変更を保存します。

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


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

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


マクロエディタ

管理者 認証情報を使用してデバイスの Web インターフェイスにサインインし、 カスタマイズ > マクロエディタに移動します。 ここでは、次の操作が可能です。

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

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

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

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

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


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

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

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

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

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

次を使用してデバイスの Web インターフェイスにサインインします。 管理者、ルームコントロール、 または インテグレータ 資格情報を入力し、次の場所に移動します カスタマイズ > UI 拡張エディター


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

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

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

  • さまざまな種類のコントロールを作成および構成します。

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

  • UI 拡張機能がいつ表示されるかを定義します。

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

UI 拡張機能をマクロに接続するには、独自の ID アイテムのために。 たとえば、トグルの ID は「lights_on」である可能性があります。 次に、画面のタップを監視するマクロを作成し、「lights_on」ボタンがタップされたことを検出すると、必要なコマンド (照明のオン/オフなど) を発行します。

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

詳細情報

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

訪問 シスコ コラボレーション開発者コミュニティ マクロやサードパーティのコードに関するヘルプが必要な場合。

参照する Room および Desk デバイスと Webex ボードのデバイス構成 ローカル Web インターフェイスにアクセスする方法については、