Changes between Version 1 and Version 2 of Audio_Dev_API


Ignore:
Timestamp:
Feb 20, 2009 9:16:55 AM (10 years ago)
Author:
bennylp
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Audio_Dev_API

    v1 v2  
    1 Placeholder for new Audio Device API 
     1= PJMEDIA Audio Device API = 
     2 
     3'''Table of Contents''' 
     4[[PageOutline(2-3,,inline)]] 
     5 
     6The '''PJMEDIA Audio Device API''' is a new sound device abstraction API/library in PJMEDIA, introduced in PJSIP version 1.1, deprecating the [http://www.pjsip.org/pjmedia/docs/html/group__PJMED__SND.htm existing sound device API]. 
     7 
     8== Background == 
     9 
     10The '''PJMEDIA Audio Device API''' was introduced as part of the implementation of [wiki:Nokia_APS_VAS_Direct APS-Direct] implementation in PJSIP version 1.1. During the design and implementation of [wiki:Nokia_APS_VAS_Direct APS-Direct] project, it was clear that the [http://www.pjsip.org/pjmedia/docs/html/group__PJMED__SND.htm existing sound device API] lacks many features that are needed to support the project. We had the choice to either patch the existing API with new features that are specific to Nokia APS, and potentially break existing applications anyway, or design a new sound device API to support all these new features as well as future enhancements, while providing some support for the old sound API and a clear migration path to the new API. 
     11 
     12 
     13== Features == 
     14 
     15The new audio device API contains the following major features. 
     16 
     17 '''Forward compatibility:''' :: 
     18 The new API has been designed to be extensible, it will support new API's as well as new features that may be introduced in the future without breaking compatibility with applications that use this API. 
     19 
     20 '''Device capabilities:''' :: 
     21 At the heart of the API is device capabilities management, where all possible audio capabilities of audio devices should be able to be handled in a generic manner. With this framework, new capabilities that may be discovered in the future can be handled in manner without breaking existing applications. 
     22 
     23 '''Built-in features:''' :: 
     24 The device capabilities framework enables applications to use audio features built-in in the device, such as echo cancellation, built-in codecs, audio routing, and volume control. 
     25 
     26 '''Codec support:''' :: 
     27 Some audio devices such as Nokia/Symbian Audio Proxy Server (APS) and Nokia VoIP Audio Services (VAS) support built-in hardware audio codecs (e.g. G.729, iLBC, and AMR), and this feature is supported by the new audio device API. 
     28 
     29