Opened 13 years ago

Closed 13 years ago

Last modified 13 years ago

#1340 closed task (fixed)

Handle native capture preview

Reported by: nanang Owned by: bennylp
Priority: normal Milestone: release-2.0-alpha2
Component: pjmedia-videodev Version: trunk
Keywords: Cc:
Backport to 1.x milestone: Backported:

Description (last modified by bennylp)

On some platforms, e.g: iOS, the capture engine can also generate preview. Such capability should be accommodated by PJMEDIA video device framework. Also PJSUA should not create "software" renderer when native preview is supported and preferred.


Application uses video preview API as usual, such as pjsua_vid_preview_start(), pjsua_vid_preview_stop(), and pjsua_vid_preview_get_win(). From the window ID, application queries the window info to check whether the specified window is a native window.


  1. pjsua_media_config.vid_preview_enable_native: specify whether PJSUA-LIB should use native preview when it's available on the device. Default is yes.
  2. pjsua_vid_win_info.is_native field specifies whether the window is a native window, i.e. not created by our software renderer. In this case, only "hwnd"field will be valid, and all window operations such as move, set show, etc. will not work on this window


New capability PJMEDIA_VID_DEV_CAP_INPUT_PREVIEW has been added. When a device supports this capability, it must also support PJMEDIA_VID_DEV_CAP_OUTPUT_WINDOW capability.

Change History (5)

comment:1 Changed 13 years ago by bennylp

  • Milestone changed from release-2.0-alpha to release-2.0-beta

comment:2 Changed 13 years ago by bennylp

  • Description modified (diff)
  • Milestone changed from release-2.0-beta to release-2.0-alpha2
  • Owner changed from ming to bennylp
  • Status changed from new to assigned
  • Type changed from defect to task

comment:3 Changed 13 years ago by bennylp

  • Description modified (diff)

comment:4 Changed 13 years ago by bennylp

  • Resolution set to fixed
  • Status changed from assigned to closed

(In [3756]) Implemented native video preview support. This closes #1340

comment:5 Changed 13 years ago by bennylp

(In [3758]) Related to preview (re #1340): handle problems with starting or stopping preview during a call

Note: See TracTickets for help on using tickets.