sl@0: // Copyright (c) 2006-2009 Nokia Corporation and/or its subsidiary(-ies).
sl@0: // All rights reserved.
sl@0: // This component and the accompanying materials are made available
sl@0: // under the terms of the License "Eclipse Public License v1.0"
sl@0: // which accompanies this distribution, and is available
sl@0: // at the URL "http://www.eclipse.org/legal/epl-v10.html".
sl@0: //
sl@0: // Initial Contributors:
sl@0: // Nokia Corporation - initial contribution.
sl@0: //
sl@0: // Contributors:
sl@0: //
sl@0: // Description:
sl@0: // \n
sl@0: // The Content Access Framework has several configurable aspects that can
sl@0: // be altered at build time.
sl@0: // <hr>
sl@0: // The F32 Agent by default has no user interface. Its interface is implemented
sl@0: // by a separate <code>F32AGENTUI.DLL</code>. This DLL can be replace with a DLL that actually
sl@0: // does display information on the screen.
sl@0: // <hr>
sl@0: // The content types that CAF is allowed to map to <code>x-caf-contentMimeType</code> are given
sl@0: // in the <code>RECCAF.DLL</code> configuration file. This file is located in the apparc server's
sl@0: // private directory as  <code>\\private\\10003a3f\\RecCaf\\RecCafMimeTypes.txt</code>.
sl@0: // Licensees should check to be sure all required MIME types are included in the file.
sl@0: // <hr>
sl@0: // The Content Access Framework's default resolution behaviour on target devices 
sl@0: // results in Content Access Agents (CAAs) only being loaded from the ROM drive. 
sl@0: // This behaviour increases the security and reliability of the Content Access 
sl@0: // Framework and is in addition to the Platform Security capabilities system.  
sl@0: // If a licensee wishes to produce a more open device relying only on capabilities 
sl@0: // to allow post production agents to be installed this default resolution 
sl@0: // behaviour can be overidden. When it is overidden CAF will load all CAAs visible 
sl@0: // to the ECOM service regardless of the drive that contains them. To do this the 
sl@0: // macro <code>CAF_LOAD_POST_PRODUCTION_AGENTS</code> will need to be defined at 
sl@0: // ROM build. In the emulator platform the default resolution behaviour is as if 
sl@0: // this macro is always defined.
sl@0: // The definition of this macro will patch a data variable in the 
sl@0: // <code>caf.dll</code> at ROM build-time. See 
sl@0: // <code>\\epoc32\\include\\caf\\patchdata.h</code> and 
sl@0: // <code>\\epoc32\\rom\\include\\caf.iby</code>.
sl@0: // <hr>
sl@0: // It is possible for device integrators to choose whether to support both protected and unprotected content or just unprotected content with the definition of the SYMBIAN_EXCLUDE_DRM_AGENT_PLUGINS macro at the ROM build stage.
sl@0: // Licensee UI platforms that wish to support this feature will need to honour this macro in the obey files of the Content Access Agents that are integrate into their platform. For example:
sl@0: // oma_caa.iby file:
sl@0: // <code>
sl@0: //
sl@0: 
sl@0: // ##ifndef __OMA_CAA_IBY__ 
sl@0: // ##define __OMA_CAA_IBY__
sl@0: // ##ifndef SYMBIAN_EXCLUDE_DRM_AGENT_PLUGINS
sl@0: // ECOM_PLUGIN(omacaa_plugin.dll,10111213.rsc)
sl@0: // file=ABI_DIR\\BUILD_DIR\\omacaa_server.exe	omacaa_server.exe
sl@0: // data=DATAZ_\\private\\10111210\\settings.ini   \\private\\10111210\\settings.ini
sl@0: // ##endif
sl@0: // ##endif
sl@0: // </code>
sl@0: // This optionality was introduced in Symbian OS v9.3 to allow easy customisation of Symbian OS. See the files RemovableFeatures.iby and feature.iby in <code>\\epoc32\\rom\\include</code>.
sl@0: //
sl@0: 
sl@0: /**
sl@0:  @page CAFLicensees Considerations for Licensees using CAF
sl@0:  @section licenseesF32AgentUi F32 Agent User Interface
sl@0:  @see ContentAccess::TF32AgentUiFactory
sl@0:  @section licenseesRECCAF CAF Recognizer Mime Types
sl@0:  @section licenseesROMOnly Allowing CAF to load non-ROM based agents
sl@0:  @section licenseesExcludeAgents Omitting Content Access Agents from ROMs
sl@0: */