December, 2003

Symbian Development for the P800/P900 API Summary

Table of Contents
Table 1. API Reference Summary for P800/P900........................................................................................................2 Table 2. Sony Ericsson Specific C++ APIs for UIQ v2.1 ............................................................................................10

Table 1. API Reference Summary for P800/P900

API
Graphics and MultiMedia Graphics 2D Accelerated Hardware accelerator Animation Bitmaps Picture Embedding Fonts Open Font System Graphics Image Converter Media Server MultiMediaCard Audio clip Image Objects AWT Graphics Components Pixel Manipulation Java Beans

C++

pJava

graphicsaccelerator.h d32hwa.h, kernel\k32hwa.h w32adll.h, wsanimu.def bitdev.h, bitmap.h, bitstd.h, fbs.h, gdi.h gdi.h fbs.h, gdi.h openfont.h gdi.h, e32std.h mdaimageconverter.h, mda\client\utility.h mda\client\utility.h, mda\common\base.h p32mmc.h java.applet.AudioClip java.applet java.awt java.awt java.awt.image java.beans java.awt.graphics java.awt

Input FEP - Front End Processors fepbase.h, fepitfr.h

Applications Agenda agmbasic.h, agmcomon.h, agmentry.h, agmexcpt.h, agmids.h, agmrepli.h, agmrptd.h, agmxentr.h agmactiv.h, agmalarm.h, agmcallb.h, agmfilts.h, agmlists.h, agmmiter.h, agmmodel.h, agmobsrv.h, agmsiter.h, agmupact.h agmdate.h, agmver.h agclient.h Alarm Clock Contacts Model PhoneBook Synchroniser To-do List Versit vCard parser t32alm.h, t32wld.h clock.h cntdb.h, cntdbobs.h, cntdef.h, cntfield.h, cntfield.h, cntfldst.h, cntitem.h phbksync.h agmbasic.h, agmcomon.h, agmentry.h, agmids.h, agmlists.h, agmtodos.h vcal.h, vcard.h, versit.h, vprop.h, vrecur.h

P800 System Clipboard Cookies Support Log Engine Power Management Framework baclipb.h ccookie.h, CCookieFilterInterface.h, httpcookieerr.h, mhttpcookiemanager.h logcli.h, logview.h, logwrap.h, logwrap.hrh kernel\k32power.h java.awt.datatransfer

Audio Audio Editor controller.h, MdaAudioSampleEditor.h, mda\client\utility.h, mda\common\audio.h, mda\common\resource.h mdaaudiosampleplayer.h, mda\common\controller.h

Audio Player

Audio Streaming Tone Player System Sounds

mdaaudiooutputstream.h MdaAudioTonePlayer.h e32def.h

Database DBMS DBMS Database Interface File Stores Persistent Paged Sets Recognizers Store Streams Stores Stream Buffers Streaming String Pool d32dbms.h d32dbms.h e32std.h, f32file.h sb32tree.h, s32page.h, s32file.h apmrec.h, apmstd.h s32std.h, s32strm.h, s32share.h s32mem.h, s32stor.h s32mem.h, s32buf.h s32strm.h stringpool.h smlchangefinder.h, smldatastore.h, smldba.h, smldefines.h, smlids.h SQL Serialization java.sql java.io java.io java.io

Synchronization SynchML Database Plug-in SynchML Synchronization Controller SynchML Transport Adapter smlchangefinder.h, smldatastore.h, smldba.h, smldefines.h, smlids.h smlcontroller.h, smlenginedefines.h, smlids.h, smlprofile.h, SmlReportingCallback.h, smltask.h smlsession.h

Transport Framework WSP Transport Handler Plug-in

wsp\CWspTransportHandler.h, wsp\MWspAliasAddresses.h, wsp\MWspCapabilityProvider.h, wsp\MWspCapabilitySetter.h, wsp\MWspCapabilityViewer.h, wsp\MWspCLMethodCallback.h, wsp\MWspCLMethodInvoker.h, wsp\MWspCLPushInvoker.h wsp\MWspCLPushCallback.h, wsp\MWspCOMethodCallback.h, wsp\MWspCOMethodInvoker.h, wsp\MWspCOPushCallback.h, wsp\MWspCOPushInvoker.h, wsp\MWspCOSessionCallback.h, wsp\MWspCOSessionInvoker.h, wsp\MWspExtendedMethods.h, wsp\MWspHeaderCodePages.h, wsp\MWspProxyInfoProvider.h, wsp\MWspSessionHeadersProvider.h, wsp\MWspUnknownCapabilities.h, wsp\WspTypes.h, wapmessage.h, wapmsgerr.h

Communication Bluetooth btmanclient.h, btsdp.h, bttypes.h, bt_sock.h, btdevice.h, btextnotifiers.h UIQ Bluetooth CommDb ECom QBTselectdlg.h cdbcols.h, cdbover.h, cdbstore.h, cdbtemp.h, commdb.h ecom.h, EComErrorCodes.h, EComResolverParams.h, ImplementationInformation.h, ImplementationProxy.h, PublicRegistry.h, RegistryInfo.rh tranp.h http\framework\cheadercodec.h, http\framework\CSecurityPolicy.h, http\framework\cprotocolhandler.h, http\framework\CProtTransaction.h, http\framework\crxdata.h, http\framework\RHeaderField.h, http\framework\MRxDataObserver.h, http\framework\SecurityPolicyPluginStrings.h, http\framework\httplogger.h d32usbc.h, kernel\k32usbc.h

InfraRed Transfer Picture Protocol Transport Framework Protocol Handler

USB Client

Messaging Messaging Architecture mentact.h, msvapi.h, msventry.h, msvfind.h, msvftext.h, msvids.h, msvipc.h, msvreg.h, msvruids.h, msvstd.h, msvstore.h, msvuids.h, mtclbase.h, mtclreg.h, mtmdef.h, mtmuibas.h, mtmuidef.h, mtmuidef.hrh, mtmuids.h, mtsr.h, mtud.hrh, mtud.rh, mtudcbas.h, mtudreg.h, mtuireg.h, sendas.h MmsClientMtm.h, MmsForwardOp.h, MmsReplyOp.h, MmsMtmCmds.h

MMS MTM Client

MMS Utilities

MmsClientMessage.h, MmsCodecMediaObjectCreator.h, mmsheaders.h, mmsmediaobject.h, mmsmediaobjectlist.h, MmsMessage.h, MmsRecipient.h, MmsSettings.h, MmsUtilsHeaderArray.h, MmsUtilsHeaderParameter.h, MmsAddressParser.h, MmsUtils.h, MmsErrors.h MDXMLCDataSection.h, MDXMLCharacterData.h, MDXMLComment.h, MDXMLComposer.h, MDXMLDocument.h, MDXMLDocumentElement.h, MDXMLElement.h, MDXMLEntityConverter.h, MDXMLNode.h, MDXMLParser.h, MDXMLProcessingInstruction.h, MDXMLSMILa.h, MDXMLSMILanchor.h, MDXMLSMILAnchorElt.h, MDXMLSMILanimation.h, MDXMLSMILarea.h, MDXMLSMILaudio.h, mdxmlsmilbasicelt.h, mdxmlsmilbody.h, MDXMLSMILComposer.h, MDXMLSMILDocument.h, MDXMLSMILEntityConverter.h, mdxmlsmilhead.h, MDXMLSMILimg.h, mdxmlsmillayout.h, mdxmlsmilmediaobject.h, MDXMLSMILmeta.h, MDXMLSMILpar.h, MDXMLSMILParser.h, MDXMLSMILref.h, MDXMLSMILregion.h, MDXMLSMILrootlayout.h, MDXMLSMILseq.h, mdxmlsmilsmil.h, mdxmlsmilswitch.h, mdxmlsmiltext.h, MDXMLSMILtextstream.h, MDXMLSMILTimedMediaObject.h, MDXMLSMILTimingElt.h, MDXMLSMILvideo.h, MDXMLText.h, SMILConstants.h, MDXMLConstants.h, MDXMLSMILAnchorBase.h smutset.h

SMIL Parser and Composer

SMS Client MTM

Networking Generic Connection Manager HTTP AgentClient.h http\CAuthenticationFilterInterface.h, http\CEComFilter.h, chttpformencoder.h, HttpStringConstants.h, httperr.h, http\rhttpsession.h, http\cecomfilter.h, http\mhttpauthenticationcallback.h, http\mhttpdatasupplier.h, http\mhttpfilterbase.h, http\mhttpfilter.h, http\MHTTPFilterCreationCallback.h, http\mhttpsessioneventcallback.h, http\mhttptransactioncallback.h, http\rhttpconnectioninfo.h, http\rhttpfiltercollection.h, http\rhttpheaders.h, http\rhttpmessage.h, http\rhttppropertyset.h, http\rhttprequest.h, http\rhttpresponse.h, http\RHTTPTransaction.h, http\rhttptransactionpropertyset.h, http\TFilterConfigurationIter.h, http\TFilterInformation.h, http\thttpevent.h, http\thttpfilterhandle.h, http\thttpfilteriterator.h, http\thttpfilterregistration.h, http\thttphdrfielditer.h, http\thttphdrval.h, WspStringConstants.h, WspCharacterSets.h, WspContentTypes.h, WspLanguages.h, WspParamConstants.h, WspRegContentTypes.h, WspStdConstants.h, WspTypeConstants.h ir_sock.h nifman.h es_prot.h, es_sock.h

IrDA Sockets Network Interface Manager Socket Server Protocols

Sockets Client TCP/IP WAP Messaging WAP Stack World Server Sockets

es_sock.h in_iface.h, in_sock.h wapmessage.h, wapmsgerr.h, WspTypes.h capcodec.h, wapcli.h t32wld.h java.net

Security Certificate Manager Encrypted Streams and Stores IP Security Security Classes Security Manager Certificates certstore.h, certstoreimp.h, signed.h, x509certchain.h, x509certext.h, x509gn.h s32crypt.h ipsecapi.h, ipsectypes.h e32base.h, e32std.h java.lang java.rmi java.security

Application Framework Architecture Framework apacmdln.h, apadbase.h, apadef.h, apaid.h, apamdr.h, apgtask.h, apparc.h apaid.h, apgcli.h, apgctl.h, apgdoor.h, apgicnfl.h, apgtask.h, apgwgnam.h bautils.h Cleanup Stack Client / Server Command Line Parsing Converter Architecture Critical Sections Device Drivers DLL Utilities Environment Change Notifier Handles Interrupt Architecture Math Functions Memory Allocation Memory Streams Message Window Notification Services Package Buffer Raw Memory e32base.h, e32std.h e32base.h, e32std.h bacline.h cnftool.rh, conarc.h, concnf.h, conlist.h e32std.h e32std.h, kernel\k32std.h e32std.h bacntf.h e32std.h kernel\k32std.h, m32std.h e32math.h e32def.h, e32std.h s32mem.h clock.h e32std.h e32std.h e32std.h

Mutexes Reference Counting Objects Semaphores System Agent System Macros System Static Functions System Error Codes Threads and Processes Timers Transfer Buffer UI Control Framework UI Graphics Utilities UID Manipulation Uikon Core

e32std.h e32base.h, e32std.h e32std.h saclient.h, sacls.h, savarset.h e32def.h e32std.h e32std.h e32std.h e32base.h, e32std.h E32TransBuf.h coeaui.h, coeauib.h, coeauis.h, coeccntx.h, coecntrl.h, coecntx.h, coecobs.h, coedef.h, coefepff.h, coehelp.h, coeinput.h, coemain.h, coeutils.h gulcolor.h, gulutil.h, gulfont.h, gulicon.h, gulpanic.h, guldef.h, gulalign.h, gulbordr.h, gulftflg.hrh e32std.h apaflrec.h, eikamnt.h, eikapp.h, eikappui.h, eikaufty.h, eikbhelp.h, eikcmobs.h, eikdef.h, eikdoc.h, eikenv.h, eikfctry.h, eikfutil.h, eikmobs.h, eikmsg.h, eikrutil.h, eikvcurs.h eikalign.h, eikbctrl.h, eikbgfty.h, eikbtgpc.h, eikbtgps.h, eikbtgrp.h, eikbutb.h, eikcmbut.h, eikconso.h, eikctgrp.h, eikedwin.h, eikedwob.h, eikenv.h, eikhkeyt.h, eikimage.h, eiklabel.h, eiklbbut.h, eiklbd.h, eiklbed.h, eiklbi.h, eiklbm.h, eiklbo.h, eiklbv.h, eiklbx.h, eikmenu.hrh, eikmenub.h, eikmenup.h, eikmnbut.h, eiksbfrm.h, eiksbobs.h, eikscbut.h, eikscrlb.h, eikspane.h, eiktbar.h, eikthumb.h, eiktxlbm.h, eiktxlbx.h, uikon.rh badef.rh, uikon.rh e32std.h coeview.h, vwsdef.h w32click.h, w32std.h eikcal.h, eikchkbx.h, eikchlst.h, eikclb.h, eikclbd.h, eikclock.h, eikcmbox.h, eikgted.h, eikhlbi.h, eikhlbm.h, eikhlbx.h, eikhopbt.h, eikon.hrh, eikopbut.h, eikprogi.h, eikrted.h, eikseced.h, eikwsel.h eikfindd.h, eikinfo.h, eikpword.h, eiktime.h cmcobs.h, cmdefs.h, cmmobs.h, cntuifinddlg.h, contactslistboxobserver.h, contacuilistdialog.h, contacuireturndata.h eikdialg.h, eikdpobs.h, eikmover.h QAgendaExternalInterface.h, QMappExtInterface.h, QTodoExternalInterface.h, QVoiceExternalInterface.h

Uikon Core Controls

Uikon Resources Version Handling View Architecture Window Server Client Side UIQ Common Controls

UIQ Common Dialogs UIQ Shared UI

UIQ Dialog Framework UIQ DNLs (Dynamic Navigation Link)

UIQ Specific Controls

qikapplication.h, qikappui.h, QikCategory.hrh, qikcategorymodel.h, qikcolorselector.h, qikdateeditor.h, qikdocument.h, qikdurationeditor.h, qikeditcategoryobserver.h, qikfloatingpointeditor.h, qikIpeditor.h, qikkeyboardcontrol.h, qiknumbereditor.h, qiknumericeditor.h, qikon.hrh, qikon.rh, qikscrollablecontainer.h, qikshutter.h, qikslider.h, qiksoundselector.h, qiktabscreen.h, qiktimeanddateeditor.h, qiktimeeditor.h, qikttimeeditor.h, qikvertoptionbuttonlist.h qikeditcategoriesdlg.h, qikSendAs.h, qikzoomdlg.h, QikSelectMediaFileDlg.h, QikEditFileFoldersDlg.h, QikSaveFileInFolderDlg.h,QikSelectAttachmentTypeDlg.h qikborderutils.h, qikdrawutils.h, qikhelplauncher.h, qikutils.h, QikMediaFileFolderUtils.h, QikMediaFolderMonitor.h, QikMediaFolderChangeNotifier.h java.lang

UIQ Specific Dialogs UIQ Specific Utilities

Runtime class access Threads and Processes Remote Method Invocation (RMI)

java.rmi

Debugging Stop Mode Debugger Interface kernel\k32dbg.h

Utility Classes Array Keys Active Objects Binary Trees Basic Types Calendar Conversion Character Conversion Circular Buffers Date and Time Descriptors Doubly Linked Lists Dynamic Arrays Dynamic Buffers Incremental Text Matcher Resource File Interface String manipulation Literal Descriptors e32base.h, e32std.h e32base.h, e32std.h s32btree.h, sb32file.h, s32crypt.h, s32stor.h, sb32tree.h e32base.h, e32def.h, e32std.h calconv.h, calconvarithmeticalcal.h, calconvastronomicalcal.h, calconvcalendar.h charconv.h, convnames.h, utf.h, convgeneratedcpp.h, convplug.h, convutils.h, e32std.h e32base.h e32std.h badesca.h, bamdesca.h, e32def.h, e32des16.h, e32des8.h, e32std.h e32std.h e32base.h, e32std.h e32base.h bamatch.h badef.rh, barsc.h, barsread.h e32std.h e32def.h, e32des16.h, e32des8.h, e32std.h

Locale Settings Singly Linked Lists Text Attributes

collate.h, e32std.h, badef.rh, banamedplugins.h e32std.h fldbase.h, fldbltin.h, fldinfo.h, medobsrv.h, txtetext.h, txtfmlyr.h, txtfrmat.h, txtglobl.h, txtlaydc.h, txtmfmtx.h, txtrich.h, txtstyle.h frmframe.h, frmlaydt.h, frmpage.h, frmparam.h, frmtlay.h, frmtview.h, frmvis.h, tagma.h QuartzFepDescription h, textinputserverclient.h, TextInputServerParameters.h java.lang java.lang java.math java.lang java.txt java.util

Text Views UIQ Text Input Class Loader Just in Time (JIT) Compiler Math Functions String manipulation Date Calendar Date Dictionary Double Buffering Timer APIs

java.awt.Component com.sun.util

Not Supported in P800/P900 ETel Fax Peripheral Bus Controller Printer Functions Serial Communications Serial Protocol Module Telephony UIQ Telephony Application etel.h, etelpckt.h, etelqos.h, pcktcs.h cfax32.h, etel.h, faxdefn.h, faxstd.h, faxset.h, faxut.h, cfaxio.h, faxstore.h k32std.h, p32std.h prninf.h, prnsetup.h, prnprev.h, gdi.h c32comm.h, d32comm.h cs_port.h telephony.h QPhoneAppExternalInterface.h

Table 2. Sony Ericsson Specific C++ APIs for UIQ v2.1 The Sony Ericsson Specific C++ APIs contain support for Vibration Symbian Onboard Camera Streaming AMR (Adaptive Multi-Rate)

This table lists the classes and methods. Note that the constructors, destructors, and new() methods have been omitted.

Vibration Classes
CVibration

Methods

Definition
Main class for creating a vibration object

Version()

Used to adapt the vibration behavior to different hardware Turns the vibration On. Parameters are on-interval, off-interval and duration time. Turns the vibration Off. Vibration observer class

VibrationOn()

VibrationOff() MVibrationObserver VibrationResponse()

Asynchronous response for VibrationOn() and VibrationOff().

Symbian OnBoard Camera Classes

CCamera

Methods

Definition
Main class for creating a camera object

SetBrightnessL() SetContrastL() SetDigitalZoomFactorL() SetExposureL() SetFlashL() SetJpegQuality() SetViewFinderMirrorL() SetWhiteBalanceL() SetZoomFactorL() CameraInfo() CamerasAvailable() CaptureImage() CancelCaptureImage() CustomInterface()

Setter methods to adjust the camera attributes. Each has a corresponding getter method for reading the current value.

Retrieve information about the camera

Asynchronously performs still image capture

Gets a custom interface

EnumerateCaptureSizes()

Enumerates through the available video frame rates, based on the index aRateIndex, the video frame format aFormat, the size index aSizeIndex and the exposure mode aExposure. Enumerates through the available video frame sizes, based on the size index aSizeIndex and format aFormat Static factory function taking an observer reference and the handle of an existing CCamera object. Turns the camera on an off

EnumerateVideoFrameSizes()

NewDuplicateL()

PowerOn() PowerOff() PrepareImageCaptureL()

Performs setup and allocation of memory prior to calling CaptureImage() to keep the latency of CaptureImage() to a minimum. Only needs to be called once for multiple CaptureImage() calls. Performs setup and allocation of memory prior to calling StartVideoCapture() to keep the latency of StartVideoCapture() to a minimum. De-initialises the camera and allows other clients to use it. Asynchronous function that performs any initialisation required and reserves the camera for exclusive use. Starts and stops video capture

PrepareVideoCaptureL()

Release()

Reserve()

StartVideoCapture() StopVideoCapture() StartViewFinderBitmapsL() StopViewFinder() StartViewFinderDirectL()

Starts transfer of view finder data via bitmaps.

Starts transfer of view finder data to the given portion of screen using direct screen access. Queries whether the corresponding function is active.

VideoCaptureActive() ViewFinderActive() ViewFinderMirror() MCameraExtensions

A class that encapsulates extended camera functionality SetNightModeL() StartViewFinderDirectL() Sets the nightmode state Asynchronous version of the original ecam method for starting the viewfinder Mixin base class for clients of the camera

MCameraObserver

FrameBufferReady()

Called asynchronously when a video frame is ready Called asynchronously when CaptureImage() completes Called asynchronously when PowerOn() completes Called asynchronously when Reserve() completes Called asynchronously when a view finder bitmap is ready for display

ImageReady()

PowerOnComplete()

ReserveComplete()

ViewFinderFrameReady()

MFrameBuffer

Buffer of video data that may contain multiple frames DataL() FrameL() Release() Access non-bitmap frames in the buffer Access bitmap frames in the buffer Releases the buffer for re-use by the camera once the client has processed the frame data The mixin class to implement in order to receive a notification when viewfinder has been started ViewFinderStarted() Called asynchronously when the viewfinder has been started by calling StartViewFinderDirectL via extended interface Contains camera enums and constants. There are no member functions.

MViewFinderObserver

TCameraInfo

Streaming AMR Classes

CStreamingAMRPlayer

Methods

Definition
A class that encapsulates decoding and playing of AMR data. The data is handled in the format specified by RFC 3267, with the exception that no file header is present

Play()

Decode and play the data. Start() must have been called prior to Play(). Prepare playing of AMR encoded data. Stop playing AMR data. Stop terminates the playback immediately. Returns the version number of the CStreamingAMRPlayer implementation

Start() Stop()

Version()

CStreamingAMRRecorder

A class that encapsulates recording and encoding of AMR data. The data is handled in the format specified by RFC 3267. Record() Record and AMR encode the data. Start() must have been called prior to Record(). Prepare capturing and AMR encoding of data Stop recording AMR data Returns the version number of the CStreamingAMRRecorder implementation The observer class to be implemented by any client to CStreamingAMRPlayer PlayBufferSent() Response to a successful CStreamingAMRPlayer::Play() request Signals that an error has occurred Response to a successful CStreamingAMRPlayer::Start() request Response to a successful CStreamingAMRPlayer::Stop() request The observer class to be implemented by any client to CStreamingAMRRecorder.

Start()

Stop() Version()

CStreamingAMRPlayerObserver

PlayerErrorOccurred() PlayerStarted()

PlayerStopped()

CStreamingAMRRecorderObserver

RecordedData()

Response to a successful CStreamingAMRRecorder::Record() request Signals that an error has occurred. This will typically occur if a service fails or if a buffer overflow error occurs. Response to a successful CStreamingAMRRecorder::Start() request. Response to a successful CStreamingAMRRecorder::Stop() request

RecorderErrorOccurred()

RecorderStarted()

RecorderStopped()