Cisco Meeting Server API 概要

Cisco Meeting Server
- API概要
シスコシステムズ合同会社
テクニカルソリューションズアーキテクト
岩岸優希
2016年9月
@yiwagish
ブログ：http://cs.co/yiwagish
えー、なんでAPI なの？
開発者じゃないのに。。。。
API（アプリケーションんプログ
ラミングインターフェース）
設定ツール
API による設定の優位性
機能実装のスピード感
顧客体験の自由度
何ができるのか？というより、いつ必要なのか？
• Spaceごとのデフォルトレイアウト
•
Webから変更可能
何ができるのか？というより、いつ必要なのか？
• CMAでレイアウト
•
Web/アプリで変更可能
何ができるのか？というより、いつ必要なのか？
• ビデオ端末からレイアウト変更
何ができるのか？というより、いつ必要なのか？
• ビデオ端末からレイアウト変更
シスコ端末 + TelePresence Server or CMR Cloud
• > アクティブコントロール (IX Protocol)で変更可能
•
2.0 未対応
何ができるのか？というより、いつ必要なのか？
• ビデオ端末からレイアウト変更
シスコ端末 + TelePresence Server or CMR Cloud
• > DTMF 2 / 8 で変更可能
•
デフォルトでは
Disable
How can I change screen layouts using
DTMF?
https://kb.acano.com/content/33/257/en/how-can-i-change-screen-layoutsusing-dtmf.html
Cisco Meeting Server API
REST （Webの仕組みと同じ）
HTMLの話
HTTPの話
RESTの話
Meeting Server
/calls
CMS
XML
XML
XML Data
Meeting Server
RESTの中身
REST アクセスツール
ブラウザのプラグインで”設定”
履歴が残るので Postmanが運用では
おすすめ
• Firefox
Poster
• Chrome Postman
• Chrome Advanced Rest Client
•
APIガイドには Firefox Poster利用例
• DevNet ラーニングガイドにはChrome Postman入門ガイド多数
Firefox Poster (入門的に)
Cisco Meeting Server API
DTMFによるレイアウト変更
- 3 Step
API ユーザの作成
DTMF Profile作成
Call Leg Profile作成
DTMFに対してのアクション
通話中のプロファイル
System Profile に割り当て
システムレベルのプロファイル
ユーザの作成
API ユーザの作成
acano> user add apiuser api
Please enter new password:
Please enter new password again:
Success
Firefox-Poster利用
RESTの基本
: 情報の取得＝ID情報
• POST : 新規設定＝新規ID作成
• PUT：設定変更＝IDに変更を加える
• DELETE：設定削除=IDを削除
• GET
DTMF Profile作成
POST Method DTMF Profile作成
https://URL/api/v1/dtmfProfiles
新規作成はPOST
nextLayout=8
次のレイアウトは”8”
200 OK
• Location
•
dtmfProfile IDをメモ
DTMF Profile作成
PUT MethodでDTMF Profile更新
DTMF Profile作成
https://URL/api/v1/dtmfProfiles/ID
更新はPUT
previousLayout=2
前のレイアウトは”2”
GET Methodで確認
DTMF Profile作成
Call Leg Profile作成
callLegProfiles作成
https://URL/api/v1/callLegProfiles
新規作成はPOST
changeLayoutAllowed=true
レイアウト変更を有効に
200 OK
• Location
•
CallLegProfile IDをメモ
Call Leg Profile作成
PUT: システムプロファイル更新
System Profile に割り当て
https://URL/api/v1/system/profiles
システムプロファイル常にPUT
callLegProfile=ID
PUT: システムプロファイル更新
System Profile に割り当て
https://URL/api/v1/system/profiles
システムプロファイル常にPUT
dtmfProfiles=ID
同じdtmfProfileで実装できるもの
ミュート制御
録画
会議ロック
会議終了
•
muteSelfAudio
•
unmuteAllNewAudio
•
unmuteSelfAudio
•
defaultMuteAllNewAudio
•
toggleMuteSelfAudio
•
muteAllNewAndAllExceptSelfAudio
•
muteAllExceptSelfAudio
•
•
unmuteAllExceptSelfAudio
unmuteAllNewAndAllExceptSelfAu
dio
•
startRecording
•
lockCall
•
stopRecording
•
unlockCall
•
muteAllNewAudio
•
endCall
APIリスト
https://URL/api/v1/xxx
•
/accessQuery
•
/coSpaces
•
/callBrandingProfiles
•
dialTransforms
•
/callBridges
•
/directorySearchLocations
•
/calls
•
/dtmfProfiles
•
/callProfiles
•
/forwardingDialPlanRules
•
/callLegs
•
inboundDialPlanRules
•
/callLegProfiles
•
/ivrs
•
/coSpaceBulkParameterSets
•
/ivrBrandingProfiles
•
/coSpaceBulkSyncs
•
/ldapMappings
APIリスト
https://URL/api/v1/xxx
•
/ldapServers
•
/tenants
•
ldapSources
•
/turnServers
•
/ldapSyncs
•
/users
•
/outboundDialPlanRUles
•
/userProfiles
•
/participants
•
/webBridges
•
/recorders
•
/system/
APIが必要な機能 FAQ
•
How do I enforce encryption for a space?
• https://kb.acano.com/content/10/70/en/how-do-i-enforce-encryption-for-aspace.html
•
Can I create multiple IVRs?
• https://kb.acano.com/content/7/179/en/can-i-create-multiple-ivrs.html
•
Can members of a space control other participants' audio or video?
• https://kb.acano.com/content/14/204/en/can-members-of-a-space-controlother-participants_-audio-or-video.html
RESTは今後も必要になりますので。。。
developer.cisco.com Learning Lab
https://learninglabs.cisco.com/lab/04-rest-01-overview-of-rest-apis/step/1

Download Report