|
|
|
The default_data section of an CA Agent or CA Agent
proxy's resource file is used to specify three pieces of information:
The buffer size required by this agent to recognize a file when
ContentAccess::CAgentManager::RecognizeFileL() is called
A list of supplier MIME types supported by this agent
A list of consumer MIME types supported by this agent.
The buffer size section is separated from the supplier MIME types by a
'|' character and the supplier MIME types are separated from the
consumer MIME types by a ':' character.
Below is an example for an OMA DRM agent.
default_data="100|application/vnd.oma.drm.message,application/vnd.oma.drm.rights+xml:application/vnd.oma.drm.content";
It requires at least the first 100 bytes of a file in order to do recognition
It supports a supplier MIME types of
application/vnd.oma.drm.message and
application/vnd.oma.drm.rights+xml
It supports a consumer MIME type of
application/vnd.oma.drm.content.
The opaque_data section is used to specify the agent's
private directory under c:\private\. This will be the
SID (SecureId) of the server which owns the directory, for example
opaque_data="12345678";
If the agent does not have a corresponding private directory or does
not wish to provide access to that directory, it should just leave the
opaque_data section as an empty string.
// 101FE8F1.rss
// UIDs quick-ref
//
// ECOM DLL UID: 0x101FE8F1
// CA Agent interface UID: 0x10204740
// Test CAA Implementation: 0x101FE8F2
#include "RegistryInfo.rh"
RESOURCE REGISTRY_INFO theInfo
{
dll_uid = 0x101FE8F1;
interfaces =
{
INTERFACE_INFO
{
interface_uid = 0x10204740;
implementations =
{
IMPLEMENTATION_INFO
{
implementation_uid = 0x101FE8F2;
version_no = 1;
display_name = "Test Agent";
default_data = "255|application/vnd.oma.drm.message,application/vnd.oma.drm.content:application/vnd.oma.drm.content";
// Sample CAF types
opaque_data = "12345678";
}
};
}
};
}
0x10009D8D — the ECOM DLL UID. Identifies a DLL
as an ECOM plugin
0x101FC2CE — the Content Access Agent v1.0
interface. An implementation of
ContentAccess::CAgentFactory::NewL().
0x10204740 — the Content Access Agent v2.0
interface. An implementation of
ContentAccess::CAgentFactory::NewL().
When writing a new CA Agent, all other UIDs used in the above examples should be replaced by new UIDs from the Symbian UID generator.