09-25-2014 10:25 AM - edited 03-18-2019 03:27 AM
How can I poll the in-use video ports from the RPC API of a 4520? I can get totalVideoPorts from the API guide, but I can't tell what API value I need to show ports in use.
09-26-2014 10:48 AM
You can get the total available ports and their modes with device.query, then do some calculations…
With current versions of MCU (API version 2.8) there isn’t a direct way of getting these information via the API. However it is possible to get port usage information by doing some calculation.
You can use ‘participant.enumerate’ command with filter ‘connected|connecting’ to get all active participants on the MCU. Then you can count the number of videoTxCodec(not none) /audioTxCodec(not none) /contentTxCodec(not none) in ‘currentState’ struct to get all the ports used.
You then need to compare the number of audioTxCodec and videoTxCodec, if the number of audioTxCodec is greater than the number of videoTxCodec it means there are audio-only participants.
Adam
09-28-2014 06:43 PM
To comment on Adam's post about the versioning of the MCU software and associated API. The most recent MCU software is 4.5, while the API version is 2.11.
telepresence-mcu-4500-series/products-programming-reference-guides-list.html
09-29-2014 12:41 AM
But the TMS Bridge Utilization Report does not separate between video and audio only calls.
As we use our 4520 bridges for phone conferences also, this would be very helpful if Cisco could update the reports for that szenario also.
And to enhance the missing API calls, we have this problem also. Compared to a simple API calls about MCU resources its a huge amount of API calls and calculating to get all MCU resources because its no so easy as it seems. For example to calculate the right video port usage you must look if a video codec is in use, if there is H.239 or streaming in use. And, calculation of that depends also from "Media port mode" settings.
09-29-2014 05:12 AM
Thanks Adam. This is definitely one way to do it. Are there any plans for the API to contain a more direct query of this information? It just seems odd that it provides totalVideoPorts but then no subsequent totalVidePortsInUse or something of the like. Likewise, totalAudioPortsInUse, totalContentPortsInUse, etc could be used..
Because of this issue, we are currently using the Status--->> Conferences screen and doing an HTML "screen scrape" to pull the Ports in use information directly from that page. As wew know that page could change in future version, we would like to see this information available through the API.
06-01-2021 01:33 PM
Thanks, @Adam Wamsley! This is a gem!
09-28-2014 05:40 PM
If it is at all helpful, TMS 14.5 has new a new Bridge Utilisization reporting function.
See Page 5 of the Release Notes.
Wayne
--
Please remember to rate responses and to mark your question as answered if appropriate.
Please remember to mark helpful responses and to set your question as answered if appropriate.
09-29-2014 05:19 AM
Thanks Wayne. We need to pull the data directly into our application and manually exporting a report is not what we are looking to do. Could we query the TMS DB directly and do the ETL ourselves?
Discover and save your favorite ideas. Come back to expert answers, step-by-step guides, recent topics, and more.
New here? Get started with these tips. How to use Community New member guide