You can supply data when launching the application control, and the called application control must process this data properly. The delivered data can be processed either using the Application::OnUserEventReceivedN() method when the application control is already running, or using the Application::GetAppArgumentListN() method when the application control is started.
The launch argument has the information of the calling application, the operation ID, category, MIME type, URI scheme, and the actual arguments. If your application exports the application control functionality, it must at least handle the launch argument for the operation ID, as it is mandatory information for delivering the launch arguments.
The application control has its operation ID and category. If you know the operation ID and the category, you have the information of the actual delivered arguments. The following table defines the input and output parameters.
| Operation ID | Category | Input data | Output data |
|---|---|---|---|
| APPCONTROL_OPERATION_ADD | APPCONTROL_CATEGORY_CONTACT | phone: <val1> | email: <val2> | url: <val3> | <> | – |
| APPCONTROL_OPERATION_CALL | APPCONTROL_CATEGORY_VIDEOCALL | tel: <phone number> type: video |
– |
| APPCONTROL_CATEGORY_VOICECALL | tel: <phone number> type: voice |
– | |
| APPCONTROL_OPERATION_CAPTURE | APPCONTROL_CATEGORY_IMAGE | type: camera | <captured file> |
| APPCONTROL_OPERATION_COMPOSE | APPCONTROL_CATEGORY_EMAIL | to: <address with ; delimiter> cc: <address with ; delimiter> bcc: <address with ; delimiter> subject: <title> text: <body> attachments: <attachment> |
– |
| APPCONTROL_CATEGORY_MMS | type: MMS to: <address with ; delimiter> cc: <address with ; delimiter>> bcc: <address with ; delimiter> subject: <title> text: <body> attachImage: <file path> attachAudio: <file path> attachVideo: <file path> |
– | |
| APPCONTROL_CATEGORY_SMS | type: SMS to: <address with ; delimiter> text: <body> |
– | |
| APPCONTROL_OPERATION_CONFIGURE | APPCONTROL_CATEGORY_SETTINGS | category: <category> | category: <category> <category-dependent> |
| APPCONTROL_OPERATION_DIAL | APPCONTROL_CATEGORY_VIDEOCALL | tel: <phone number> |
– |
| APPCONTROL_CATEGORY_VOICECALL | tel: <phone number> |
– | |
| APPCONTROL_OPERATION_PICK | APPCONTROL_CATEGORY_AUDIO | type: audio selectionType: single | multiple |
<file path> <file path 2> ... |
| APPCONTROL_CATEGORY_BLUETOOTH | – | <address> <device name> <major class type> <minor class type> <service class type> <service type> |
|
| APPCONTROL_CATEGORY_CALENDAR | itemType: event | todo | memo | event | todo | memo
<file path> |
|
| APPCONTROL_CATEGORY_CERTIFICATE | – | <certificate ID> | |
| APPCONTROL_CATEGORY_CONTACT | selectionMode: single | multiple returnType: phone | email | contactId | vcard |
phone | email | contactId | vcard <selection value> <selection value2> … |
|
| APPCONTROL_CATEGORY_IMAGE | type: image selectionType: single | multiple |
<file path>
<file path 2> … |
|
| APPCONTROL_CATEGORY_MEDIA | type: audio | image | video | all selectionType: single | multiple |
<file path>
<file path 2> … |
|
| APPCONTROL_CATEGORY_VIDEO | type: video selectionType: single | multiple |
<file path>
<file path 2> … |
|
| APPCONTROL_OPERATION_PLAY | APPCONTROL_CATEGORY_AUDIO | type: audio path: <file path> |
– |
| APPCONTROL_CATEGORY_VIDEO | type: video path: <file path> |
– | |
| APPCONTROL_OPERATION_RECORD | APPCONTROL_CATEGORY_VIDEO | type: camcorder maxRecordingSize: <size> |
<captured file> |
| APPCONTROL_OPERATION_SHARE | APPCONTROL_CATEGORY_AUDIO | type: audio path: <file path> |
– | APPCONTROL_CATEGORY_CALENDAR | viewType: vcs | ics path: <file path> |
– | APPCONTROL_CATEGORY_CONTACT | viewType: vcf path: <file path> |
– | APPCONTROL_CATEGORY_IMAGE | type: image path: <file path> |
– | APPCONTROL_CATEGORY_VIDEO | type: video path: <file path> |
– |
| APPCONTROL_OPERATION_SIGNIN | APPCONTROL_CATEGORY_SECURITY | – | reason: ConnectionFailed | StartFailed | NoSimInserted | ServerDomainChanged |
| APPCONTROL_OPERATION_SIGNOUT | APPCONTROL_CATEGORY_SECURITY | – | – |
| APPCONTROL_OPERATION_VIEW | APPCONTROL_CATEGORY_CALENDAR | viewType: vcs | event | todo path: <file path> | eventId: <event id> | todoId: <todo id> |
– |
| APPCONTROL_CATEGORY_CONTACT | viewType: vcf | contact path: <file path> | contactId: <contact Id> |
– | |
| APPCONTROL_CATEGORY_IMAGE | type: image path: <file path> |
– | |
| APPCONTROL_CATEGORY_BROWSER | url: <url string> | – |