Opened 13 years ago

Last modified 13 years ago

#1263 closed task

Video API for PJSUA-LIB — at Version 3

Reported by: bennylp Owned by: bennylp
Priority: major Milestone: release-2.0-alpha
Component: pjsua-lib Version: 2.0-dev-branch
Keywords: Cc:
Backport to 1.x milestone: Backported:

Description (last modified by bennylp)

PJSUA-LIB video API specification:

1. Video Device Enumeration API


  1. query device count
  2. query device names
  3. hotswap support?

2. Video Call API


  1. enable or disable video when initiating call
  2. enable or disable video when receiving call
  3. choose which device to use for video call
  4. add and remove video media stream during the call
  5. change which device to use during the call
  6. hide remote video window
  7. move and/or resize video window


Q: when receiving incoming call or reinvite which adds video, how can the app confirm this to the user?
A: at the moment, it incoming video will be accepted automatically, but the app may simply hide the window until it gets user confirmation, if needed.

Q: when receiving incoming call or reinvite with video, should we start sending automatically?
A: at the moment the answer tends to be no, as sending video is an operation that can be initiated independent .

3. Video Capture Preview API


  1. start and stop preview for the specified camera device, independent of calls
  2. preview more than one capture devices independently
  3. move and/or resize preview window

4. Media Info and Statistic API

The new API can be used for both audio and video.


  1. query the number of media streams in a call
  2. query the media stream info
  3. query the media stream statistic
  4. query the media transport info/statistic
  5. move pjsua function that dumps call statistic (i.e. "dq" command) to a separate size, to reduce footprint for apps that don't use it.

5. Notification API

Nothing special for video. Update in media status is reported in on_media_state() callback as usual. Application may use media status API to query about video status.

Change History (3)

comment:1 Changed 13 years ago by bennylp

  • Priority changed from normal to major

comment:2 Changed 13 years ago by bennylp

  • Description modified (diff)
  • Summary changed from API: video status and notification to Video API for PJSUA-LIB

comment:3 Changed 13 years ago by bennylp

  • Description modified (diff)
Note: See TracTickets for help on using tickets.