|
1 <?xml version="1.0" encoding="utf-8"?> |
|
2 <!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. --> |
|
3 <!-- This component and the accompanying materials are made available under the terms of the License |
|
4 "Eclipse Public License v1.0" which accompanies this distribution, |
|
5 and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". --> |
|
6 <!-- Initial Contributors: |
|
7 Nokia Corporation - initial contribution. |
|
8 Contributors: |
|
9 --> |
|
10 <!DOCTYPE concept |
|
11 PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd"> |
|
12 <concept id="GUID-4AAABD77-C08E-5EE2-A02A-3B412EA6D23F" xml:lang="en"><title>Advanced |
|
13 Audio Adaptation Framework Overview</title><prolog><metadata><keywords/></metadata></prolog><conbody> |
|
14 <p>This document introduces you to the Advanced Audio Adaptation Framework |
|
15 (A3F) component. </p> |
|
16 <section><title>Purpose</title> <p>A3F provides the interface between the |
|
17 Symbian platform and the audio processing hardware for all audio functionality. |
|
18 A3F is responsible for: </p> <ul> |
|
19 <li id="GUID-A2084086-B7AF-53FA-95D6-B4F209686B74"><p>Providing access to |
|
20 all audio resources </p> </li> |
|
21 <li id="GUID-11DB1466-1010-5FAC-A5A3-2FBB6C609385"><p>Configuring audio hardware </p> </li> |
|
22 <li id="GUID-B7AD5DC5-C6F4-55FA-9D2B-DF138FDF8576"><p>Playing and recording |
|
23 audio data </p> </li> |
|
24 <li id="GUID-C3A15684-26C2-5013-8C1D-05C959B16008"><p>Playing tones. </p> </li> |
|
25 </ul> </section> |
|
26 <section><title>Required background</title> <p>In order to use A3F, you should |
|
27 be familiar with <xref href="GUID-2D3F7471-9B92-5E49-B8BC-E0FA7AA709D7.dita">DevSound</xref>. </p> </section> |
|
28 <section><title>Architectural relationships</title> <p>A3F is a component |
|
29 in the Sound Device collection. A3F provides a new standardised implementation |
|
30 of DevSound which is configured by default from Symbian OS v9.5 onwards. A3F |
|
31 interacts with a specially customised DevSound (configured as optional). </p> <p>Shown |
|
32 below is a representation of how A3F interacts with DevSound and other components: </p> <fig id="GUID-D45D43BE-CC91-5A92-B9C4-7E43B3899067"> |
|
33 <title> A3F and related components </title> |
|
34 <image href="GUID-37C193CD-3D8A-56A5-B78C-0A6FE7163EC2_d0e330426_href.png" placement="inline"/> |
|
35 </fig> </section> |
|
36 <section><title>Library summary</title> <p>A3F includes the following libraries: </p> <table id="GUID-9A61E505-E46F-5811-9EC3-742AFD7444DE"> |
|
37 <tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/> |
|
38 <thead> |
|
39 <row> |
|
40 <entry>Library</entry> |
|
41 <entry>Description</entry> |
|
42 </row> |
|
43 </thead> |
|
44 <tbody> |
|
45 <row> |
|
46 <entry><p> <b>Audio Component Framework</b> </p> </entry> |
|
47 <entry><p>The Audio Component Framework is responsible for creating audio |
|
48 contexts. </p> <p>For more information, see <xref href="GUID-39B5850D-EAAD-56BC-B75A-2104033814E6.dita">Audio |
|
49 Component Framework Overview</xref>. </p> </entry> |
|
50 </row> |
|
51 <row> |
|
52 <entry><p> <b> Audio Component Library</b> </p> </entry> |
|
53 <entry><p>The Audio Component Library provides runtime control over audio |
|
54 streams. </p> <p>For more information, see <xref href="GUID-06A43E09-CC6D-5799-A0F7-68B5696F4ADB.dita">Audio |
|
55 Component Library Overview</xref>. </p> </entry> |
|
56 </row> |
|
57 </tbody> |
|
58 </tgroup> |
|
59 </table> </section> |
|
60 <section><title>Typical uses</title> <p>You can use A3F to play tones, play |
|
61 audio and record audio. The following list describes some of the steps involved |
|
62 in playing and recording audio: </p> <ul> |
|
63 <li id="GUID-E687D6B5-5844-513C-A70A-54671ECB9E2E"><p><xref href="GUID-931207BE-3561-562D-8F67-0FB52CFF83CD.dita#GUID-931207BE-3561-562D-8F67-0FB52CFF83CD/GUID-9027F6F9-F8AB-5A87-A1D3-9A554C014296">Create a new audio context</xref> </p> </li> |
|
64 <li id="GUID-BD2EF59E-DA7B-585C-9F83-4DDB7AAC32DA"><p><xref href="GUID-931207BE-3561-562D-8F67-0FB52CFF83CD.dita#GUID-931207BE-3561-562D-8F67-0FB52CFF83CD/GUID-F4E5DAD7-74D0-5946-98E5-D13C3FDF0F0D"> Apply changes made to the audio processing units in a context</xref> </p> </li> |
|
65 <li id="GUID-B9A47D94-8A0A-51A7-B982-481952597C68"><p><xref href="GUID-2A543E1C-F3DE-59EF-8A43-1B655F367FBC.dita#GUID-2A543E1C-F3DE-59EF-8A43-1B655F367FBC/GUID-14D6294E-64FB-58D9-85F8-FAE2A14367B1">Configure hardware devices, for example, set sampling rate and channels to |
|
66 use.</xref> </p> </li> |
|
67 <li id="GUID-87F43B01-8965-5EF6-BE11-C5AE5B8B5573"><p><xref href="GUID-2A543E1C-F3DE-59EF-8A43-1B655F367FBC.dita#GUID-2A543E1C-F3DE-59EF-8A43-1B655F367FBC/GUID-F6BC242F-E977-5A57-B90D-00D8A6AF5BF8">Play buffered audio data</xref> </p> </li> |
|
68 <li id="GUID-509BF8AC-40D1-5378-B133-F0D9A5AE8DD6"><p><xref href="GUID-2A543E1C-F3DE-59EF-8A43-1B655F367FBC.dita#GUID-2A543E1C-F3DE-59EF-8A43-1B655F367FBC/GUID-C91CCA5D-2E5B-58D0-9EEE-B5F6C0095E2A">Record audio data to buffers</xref> </p> </li> |
|
69 <li id="GUID-E9D7E5BF-9561-5CAD-A21F-E8BC38605F82"><p><xref href="GUID-2A543E1C-F3DE-59EF-8A43-1B655F367FBC.dita#GUID-2A543E1C-F3DE-59EF-8A43-1B655F367FBC/GUID-E2FC5EC6-57C0-53BB-9A5F-DC8BDA12E725">Pause audio processing</xref> </p> </li> |
|
70 <li id="GUID-FB41A648-5084-5ADC-A695-22896CB36E62"><p><xref href="GUID-2A543E1C-F3DE-59EF-8A43-1B655F367FBC.dita#GUID-2A543E1C-F3DE-59EF-8A43-1B655F367FBC/GUID-495DC719-47C6-50B0-9A2D-9B00BEBA0E38">Stop playing audio</xref> </p> </li> |
|
71 <li id="GUID-53299A88-3789-5286-80E2-DE479EB852D9"><p><xref href="GUID-2A543E1C-F3DE-59EF-8A43-1B655F367FBC.dita#GUID-2A543E1C-F3DE-59EF-8A43-1B655F367FBC/GUID-93CB9072-728A-598E-AD61-141D7FC9257E">Stop recording audio</xref>. </p> </li> |
|
72 </ul> </section> |
|
73 <section><title>See also</title> <p><xref href="GUID-2D3F7471-9B92-5E49-B8BC-E0FA7AA709D7.dita"> DevSound |
|
74 Overview</xref> </p> <p><xref href="GUID-A243699D-699C-5E45-A000-54C8DB4FF7AB.dita">Multimedia |
|
75 Framework Overview</xref> </p> </section> |
|
76 </conbody></concept> |