<li><a href="#browser">Browser</a></li>
<li><a href="#calendar">Calendar</a></li>
<li><a href="#call">Call</a></li>
+ <li><a href="#camera">Camera</a></li>
<li><a href="#contact">Contact</a></li>
<li><a href="#email">Email</a></li>
+ <li><a href="#file">File Storage</a></li>
<li><a href="#map">Map</a></li>
<li><a href="#message">Message</a></li>
- <li><a href="#settings_bluetooth">Settings for Bluetooth</a></li>
- <li><a href="#settings_location">Settings for Location</a></li>
- <li><a href="#settings_nfc">Settings for NFC</a></li>
- <li><a href="#settings_wifi">Settings for Wi-Fi</a></li>
+ <li><a href="#multimedia">Multimedia</a></li>
<li><a href="#settings_main">System Settings</a></li>
+ <ul>
+ <li><a href="#settings_bluetooth">System Settings for Bluetooth</a></li>
+ <li><a href="#settings_location">System Settings for Location</a></li>
+ <li><a href="#settings_nfc">System Settings for NFC</a></li>
+ <li><a href="#settings_wifi">System Settings for Wi-Fi</a></li>
+ </ul>
+ <li><a href="#voice">Voice Recorder</a></li>
</ul>
<p class="toc-title">Related Info</p>
<ul class="toc">
<div id="container"><div id="contents"><div class="content">
<h1>Common Application Controls</h1>
-<p>The following sections introduce the common application controls provided by the Tizen base applications.</p>
+<p>The following sections introduce the common application controls.</p>
<h2 id="browser" name="browser">Browser</h2>
<p>To find what you are looking for on the Web, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_SEARCH</span> operation.</p>
<p class="figure">Figure: Performing a Web search</p>
-<p align="center"><img src="../../images/common_appcontrol_browser.png" alt="Performing a Web search" /></p>
+<p align="center"><img width = "240" heiht = "480" src="../../images/common_appcontrol_browser.png" alt="Performing a Web search" /></p>
<h4>Operation</h4>
<p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_SEARCH</span></p>
-
+<h4>URI</h4>
+ <p>N/A</p>
+<h4>MIME Type</h4>
+ <p>N/A</p>
<h4>Extra Input</h4>
<table>
<tbody>
</tr>
</tbody>
</table>
-
+<h4>Extra Output</h4>
+ <p>N/A</p>
<h4>Example Code</h4>
<pre class="prettyprint">
app_control_h app_control;
<h3>Loading a Web Page</h3>
<p>To open a web page, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_VIEW</span> operation and specify the Web URL in the URI.</p>
+<table class="note">
+ <tbody>
+ <tr>
+ <th class="note">Note</th>
+ </tr>
+ <tr>
+ <td class="note">Tizen mobile platform provides this application control by default. </td>
+ </tr>
+ </tbody>
+</table>
<p class="figure">Figure: Loading a Web page</p>
-<p align="center"><img src="../../images/common_appcontrol_browser2.png" alt="Loading a Web page" /></p>
+<p align="center"><img width = "240" heiht = "480" src="../../images/common_appcontrol_browser2.png" alt="Loading a Web page" /></p>
<h4>Operation</h4>
<p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_VIEW</span></p>
<li><span style="font-family: Courier New,Courier,monospace">application/xhtml+xml</span></li>
<li><span style="font-family: Courier New,Courier,monospace">text/plain</span></li>
</ul>
-
+<h4>Extra Input</h4>
+ <p>N/A</p>
+<h4>Extra Output</h4>
+ <p>N/A</p>
<h4>Example Code</h4>
<pre class="prettyprint">
app_control_h app_control;
<p>To add a new event to the user's calendar, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_ADD</span> operation with the <span style="font-family: Courier New,Courier,monospace">application/vnd.tizen.calendar</span> MIME type. To specify various event details, refer to the extras defined below.</p>
<p class="figure">Figure: Adding a calendar event</p>
-<p align="center"><img src="../../images/common_appcontrol_calendar.png" alt="Adding a calendar event" /></p>
+<p align="center"><img width="240" height="400" src="../../images/common_appcontrol_calendar.png" alt="Adding a calendar event" /></p>
<h4>Operation</h4>
<p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_ADD</span></p>
+<h4>URI</h4>
+ <p>N/A</p>
<h4>MIME Type (Mandatory)</h4>
<p><span style="font-family: Courier New,Courier,monospace">application/vnd.tizen.calendar</span></p>
<h4>Extra Input</h4>
<tr>
<td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_CALENDAR_ALLDAY</span></td>
<td>The string to indicate if an event applies to all day. Available values are <span style="font-family: Courier New,Courier,monospace">true</span> or <span style="font-family: Courier New,Courier,monospace">false</span>. This key must be passed as a string.</td>
- <td rowspan="5">This key is optional.</td>
+ <td rowspan="5" style="vertical-align:middle">This key is optional.</td>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_CALENDAR_START_TIME</span></td>
app_control_create(&service);
app_control_set_operation(service, APP_CONTROL_OPERATION_ADD);
-app_control_add_extra_data(service, APP_CONTROL_DATA_TITLE, "Meeting with Jason");
+app_control_set_mime(service, "application/vnd.tizen.calendar");
+app_control_add_extra_data(service, APP_CONTROL_DATA_TITLE, "My event");
+app_control_add_extra_data(service, APP_CONTROL_DATA_TEXT, "My event text");
app_control_set_launch_mode(service, APP_CONTROL_LAUNCH_MODE_GROUP);
app_control_send_launch_request(service, NULL, NULL);
<p>To edit an existing event in the user's calendar, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_EDIT</span> operation with the <span style="font-family: Courier New,Courier,monospace">application/vnd.tizen.calendar</span> MIME type. To specify various event details, refer to the extras defined below.</p>
<p class="figure">Figure: Editing a calendar event</p>
-<p align="center"><img src="../../images/common_appcontrol_calendar4.png" alt="Editing a calendar event" /></p>
+<p align="center"><img width = "240" height = "400" src="../../images/common_appcontrol_calendar4.png" alt="Editing a calendar event" /></p>
<h4>Operation</h4>
<p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_EDIT</span></p>
+<h4>URI</h4>
+<p>N/A</p>
<h4>MIME Type (Mandatory)</h4>
<p><span style="font-family: Courier New,Courier,monospace">application/vnd.tizen.calendar</span></p>
<h4>Extra Input</h4>
<tr>
<td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_CALENDAR_ALLDAY</span></td>
<td>The string to indicate if an event applies to all day. Available values are <span style="font-family: Courier New,Courier,monospace">true</span> or <span style="font-family: Courier New,Courier,monospace">false</span>. This key must be passed as a string.</td>
- <td rowspan="5">This key is optional.</td>
+ <td rowspan="5" style="vertical-align:middle">This key is optional.</td>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_CALENDAR_START_TIME</span></td>
app_control_create(&service);
app_control_set_operation(service, APP_CONTROL_OPERATION_EDIT);
+app_control_set_mime(service, "application/vnd.tizen.calendar");
app_control_add_extra_data(service, APP_CONTROL_DATA_ID, "42");
-app_control_add_extra_data(service, APP_CONTROL_DATA_TITLE, "Meeting with Jason");
+app_control_add_extra_data(service, APP_CONTROL_DATA_TITLE, "Edited Title");
+app_control_add_extra_data(service, APP_CONTROL_DATA_CALENDAR_ALL_DAY, "true");
app_control_set_launch_mode(service, APP_CONTROL_LAUNCH_MODE_GROUP);
app_control_send_launch_request(service, NULL, NULL);
<h3>Viewing a Calendar Event</h3>
-<p>To display a specified event in the user's calendar, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_VIEW</span> operation with the <span style="font-family: Courier New,Courier,monospace">application/vnd.tizen.calendar</span> MIME type. To specify various event details, refer to the extras defined below.</p>
-<p>In case of viewing an event from a VCalendar file, the file path URI and <span style="font-family: Courier New,Courier,monospace">text/x-vcalendar</span> MIME type must be specified. In case of viewing an event by an event ID, the event ID (ID in the <span style="font-family: Courier New,Courier,monospace">_calendar_event</span> view) extra data and <span style="font-family: Courier New,Courier,monospace">application/vnd.tizen.calendar</span> MIME type must be specified.</p>
+<p>To display a specified event in the user's calendar, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_VIEW</span> operation. To specify various event details, refer to the extras defined below.</p>
+<p>To display a specified event from vcalendar file, use file: URI. To display a specified event using calendar id, use application/vnd.tizen.calendar MIME type with APP_CONTROL_DATA_ID.</p>
<p class="figure">Figure: Viewing a calendar event</p>
-<p align="center"><img src="../../images/common_appcontrol_calendar2.png" alt="Viewing a calendar event" /></p>
+<p align="center"><img width="240" height="400" src="../../images/common_appcontrol_calendar2.png" alt="Viewing a calendar event" /></p>
<h4>Operation</h4>
<p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_VIEW</span></p>
<p>For example: <span style="font-family: Courier New,Courier,monospace">file://<media storage path>/file.vcs</span></p>
<h4>MIME Type</h4>
<ul>
- <li><span style="font-family: Courier New,Courier,monospace">application/vnd.tizen.calendar</span></li>
- <li><span style="font-family: Courier New,Courier,monospace">text/x-vcalendar</span></li>
+ <li><span style="font-family: Courier New,Courier,monospace">application/vnd.tizen.calendar</span>
+ <p>In case of viewing an event by an event ID, the event ID (ID in the <span style="font-family: Courier New,Courier,monospace">_calendar_event</span> view) extra data and <span style="font-family: Courier New,Courier,monospace">application/vnd.tizen.calendar</span> MIME type must be specified.</p>
+ </li>
+ <li><span style="font-family: Courier New,Courier,monospace">text/x-vcalendar (for vcalendar file)</span></li>
+ <li><span style="font-family: Courier New,Courier,monospace">text/vcalendar (for vcalendar file)</span></li>
</ul>
<h4>Extra Input</h4>
<table>
</tr>
</tbody>
</table>
+<h4>Extra Input</h4>
+<p>N/A</p>
<h4>Example Code</h4>
<pre class="prettyprint">
// To view a calendar event from a vcs file
<p>To select a specified event in the user's calendar, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_PICK</span> operation with the <span style="font-family: Courier New,Courier,monospace">application/vnd.tizen.calendar</span> MIME type. To specify various event details, refer to the extras defined below.</p>
<p class="figure">Figure: Selecting a calendar event</p>
-<p align="center"><img src="../../images/common_appcontrol_calendar3.png" alt="Selecting a calendar event" /></p>
+<p align="center"><img width="240" height="400" src="../../images/common_appcontrol_calendar3.png" alt="Selecting a calendar event" /></p>
<h4>Operation</h4>
<p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_PICK</span></p>
+<h4>URI</h4>
+<p>N/A</p>
<h4>MIME Type (Mandatory)</h4>
<p><span style="font-family: Courier New,Courier,monospace">application/vnd.tizen.calendar</span></p>
<h4>Extra Input</h4>
<tr>
<td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_TYPE</span></td>
<td>The type of items to be delivered. The available values are <span style="font-family: Courier New,Courier,monospace">id</span> and <span style="font-family: Courier New,Courier,monospace">vcs</span> (<span style="font-family: Courier New,Courier,monospace">id</span> is the default, if not presented). This key must be passed as a string.</td>
- <td rowspan="3">This key is optional.</td>
+ <td rowspan="3" style="vertical-align:middle">This key is optional.</td>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_SELECTION_MODE</span></td>
app_control_create(&service);
app_control_set_operation(service, APP_CONTROL_OPERATION_PICK);
+app_control_set_mime(service, "application/vnd.tizen.calendar");
app_control_add_extra_data(service, APP_CONTROL_DATA_TYPE, "id");
app_control_add_extra_data(service, APP_CONTROL_ SELECTION_MODE, "single");
app_control_set_launch_mode(service, APP_CONTROL_LAUNCH_MODE_GROUP);
<h3>Making a Phone Call</h3>
<p>To directly initiate a phone call, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_CALL</span> operation with a phone number URI scheme.</p>
<p class="figure">Figure: Making a phone call</p>
-<p align="center"><img src="../../images/common_appcontrol_call1.png" alt="Making a phone call" /></p>
+<p align="center"><img width="240" height="400" src="../../images/common_appcontrol_call1.png" alt="Making a phone call" /></p>
<h4>Operation</h4>
<p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_CALL</span></p>
<h4>URI (Mandatory)</h4>
<p><span style="font-family: Courier New,Courier,monospace">tel:<number></span></p>
<p>For example: <span style="font-family: Courier New,Courier,monospace">tel:+821234567890</span></p>
+<h4>MIME Type</h4>
+<p>N/A</p>
+<h4>Extra Input</h4>
+<p>N/A</p>
+<h4>Extra Output</h4>
+<p>N/A</p>
<h4>Code Example</h4>
<pre class="prettyprint">
void
app_control_h request = NULL;
app_control_create(&request);
app_control_set_operation(request, APP_CONTROL_OPERATION_CALL);
- app_control_set_uri(request, "tel:+380665554433");
+ app_control_set_uri(request, "0123456789");
app_control_send_launch_request(request, NULL, NULL);
app_control_destroy(request);
<p>To open a call application and display a predefined a phone number, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_DIAL</span> action with a phone number URI scheme. When the call application opens, it displays the phone number, but the user must press the <strong>Call</strong> button to initiate the phone call.</p>
<p class="figure">Figure: Launching a Call application</p>
-<p align="center"><img src="../../images/common_appcontrol_call2.png" alt="Launching a Call application" /></p>
+<p align="center"><img width="240" height="400" src="../../images/common_appcontrol_call2.png" alt="Launching a Call application" /></p>
<h4>Operation</h4>
<p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_DIAL</span></p>
<h4>URI (Optional)</h4>
<p><span style="font-family: Courier New,Courier,monospace">tel:<number></span></p>
+ <p>If empty, a dialler UI without number will be presented.</p>
<p>For example: <span style="font-family: Courier New,Courier,monospace">tel:+821234567890</span></p>
+<h4>MIME Type</h4>
+<p>N/A</p>
+<h4>Extra Input</h4>
+<p>N/A</p>
+<h4>Extra Output</h4>
+<p>N/A</p>
<h4>Example Code</h4>
<pre class="prettyprint">
void
app_control_h request = NULL;
app_control_create(&request);
app_control_set_operation(request, APP_CONTROL_OPERATION_DIAL);
- app_control_set_uri(request "tel:+380665554433");
+ app_control_set_uri(request, 0123456789);
app_control_send_launch_request(request, NULL, NULL);
app_control_destroy(request);
</pre>
-<h2 id="contact" name="contact">Contact</h2>
+<h2 id="camera" name="camera">Camera</h2>
+
+<h3>Capture a picture or video</h3>
+<p>To take picture or record video, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_CREATE_CONTENT</span> operation with the MIME type. To specify an option, refer to the extras defined below.</p>
+<p class="figure">Figure: Taking pictures (Left) and recording videos (Right)</p>
+<p align="center"><img width="240" height="400" src="../../images/common_appcontrol_camera.png" alt="Taking picture" /> <img width="240" height="400" src="../../images/common_appcontrol_camera2.png" alt="Recording video" /></p>
+<h4>Operation</h4>
+ <p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_CREATE_CONTENT</span></p>
+<h4>URI</h4>
+<p>N/A</p>
+<h4>MIME Type (Mandatory)</h4>
+ <p><span style="font-family: Courier New,Courier,monospace">image/*</span></p>
+ <p><span style="font-family: Courier New,Courier,monospace">video/*</span></p>
+
+<h4>Extra Input</h4>
+ <table>
+ <tbody>
+ <tr>
+ <th>Key</th>
+ <th>Description</th>
+ <th>Note</th>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_TOTAL_SIZE</span></td>
+ <td>The total size of items to be returned in bytes. This key must be passed as a string.</td>
+ <td>This key is optional.</td>
+ </tr>
+ </tbody>
+ </table>
+<h4>Extra Output</h4>
+ <table>
+ <tbody>
+ <tr>
+ <th>Key</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_SELECTED</span></td>
+ <td>The path of the created image or video file. This key must be passed as a string.</td>
+ </tr>
+ </tbody>
+ </table>
+<h4>Example Code</h4>
+<pre class="prettyprint">
+#include <app_control.h>
+
+app_control_h service;
+app_control_create(&service);
+
+app_control_set_operation(service, APP_CONTROL_OPERATION_CREATE_CONTENT);
+app_control_set_mime(service, “image/png”);
+app_control_send_launch_request(service, NULL, NULL);
+
+app_control_destory(service);
+</pre>
+
+<h3>Capture a picture</h3>
+<p>To capture still image, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_IMAGE_CAPTURE</span> operation. To specify an option, refer to the extras defined below.</p>
+<p class="figure">Figure: Taking a picture</p>
+<p align="center"><img width="240" height="400" src="../../images/common_appcontrol_camera.png" alt="Taking picture" /></p>
+<h4>Operation</h4>
+ <p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_IMAGE_CAPTURE</span></p>
+<h4>URI</h4>
+<p>N/A</p>
+<h4>MIME Type</h4>
+<p>N/A</p>
+
+<h4>Extra Input</h4>
+ <table>
+ <tbody>
+ <tr>
+ <th>Key</th>
+ <th>Description</th>
+ <th>Note</th>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_TOTAL_SIZE</span></td>
+ <td>The total size of items to be returned in bytes. This key must be passed as a string.</td>
+ <td>This key is optional.</td>
+ </tr>
+ </tbody>
+ </table>
+<h4>Extra Output</h4>
+ <table>
+ <tbody>
+ <tr>
+ <th>Key</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_SELECTED</span></td>
+ <td>The path of the created file. This key must be passed as a string.</td>
+ </tr>
+ </tbody>
+ </table>
+<h4>Example Code</h4>
+<pre class="prettyprint">
+#include <app_control.h>
+
+app_control_h service;
+app_control_create(&service);
+
+app_control_set_operation(service, APP_CONTROL_OPERATION_IMAGE_CAPTURE);
+app_control_send_launch_request(service, NULL, NULL);
+
+app_control_destory(service);
+
+</pre>
+
+<h3>Capture a video</h3>
+<p>To record video, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_VIDEO_CAPTURE</span> operation. To specify an option, refer to the extras defined below.</p>
+<p class="figure">Figure: Record a video</p>
+<p align="center"><img width="240" height="400" src="../../images/common_appcontrol_camera2.png" alt="Recording video" /></p>
+<h4>Operation</h4>
+ <p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_VIDEO_CAPTURE</span></p>
+<h4>URI</h4>
+<p>N/A</p>
+<h4>MIME Type</h4>
+<p>N/A</p>
+
+<h4>Extra Input</h4>
+ <table>
+ <tbody>
+ <tr>
+ <th>Key</th>
+ <th>Description</th>
+ <th>Note</th>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_TOTAL_SIZE</span></td>
+ <td>The total size of items to be returned in bytes. This key must be passed as a string.</td>
+ <td>This key is optional.</td>
+ </tr>
+ </tbody>
+ </table>
+<h4>Extra Output</h4>
+ <table>
+ <tbody>
+ <tr>
+ <th>Key</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_SELECTED</span></td>
+ <td>The path of the created file. This key must be passed as a string.</td>
+ </tr>
+ </tbody>
+ </table>
+<h4>Example Code</h4>
+<pre class="prettyprint">
+#include <app_control.h>
+
+app_control_h service;
+app_control_create(&service);
+
+app_control_set_operation(service, APP_CONTROL_OPERATION_VIDEO_CAPTURE);
+app_control_send_launch_request(service, NULL, NULL);
+
+app_control_destory(service);
+
+
+</pre>
+<h2 id="contact" name="contact">Contact</h2>
<h3>Adding a Contact</h3>
<p>To add a new contact, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_ADD</span> operation with the <span style="font-family: Courier New,Courier,monospace">application/vnd.tizen.contact</span> MIME type. To specify various contact details, refer to the extras defined below.</p>
<p class="figure">Figure: Adding a contact</p>
-<p align="center"><img src="../../images/common_appcontrol_contact_add.png" alt="Adding a contact" /></p>
+<p align="center"><img width="240" height="400" src="../../images/common_appcontrol_contact_add.png" alt="Adding a contact" /></p>
<h4>Operation</h4>
<p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_ADD</span></p>
+<h4>URI</h4>
+<p>N/A</p>
<h4>MIME Type (Mandatory)</h4>
<p><span style="font-family: Courier New,Courier,monospace">application/vnd.tizen.contact</span></p>
<h4>Extra Input</h4>
<tr>
<td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_PHONE</span></td>
<td>The phone number. This key must be passed as a string.</td>
- <td rowspan="4">This key is optional.</td>
+ <td rowspan="4" style="vertical-align:middle">This key is optional.</td>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_EMAIL</span></td>
</table>
<h4>Example Code</h4>
<pre class="prettyprint">
-int
-launchContactCreate(const char *number)
-{
+
app_control_h request;
app_control_create(&request);
app_control_set_operation(request, APP_CONTROL_OPERATION_ADD);
app_control_set_mime(request, "application/vnd.tizen.contact");
-
- if (number)
- {
- app_control_add_extra_data(request, APP_CONTROL_DATA_PHONE, number);
- }
+
+ app_control_add_extra_data(request, APP_CONTROL_DATA_PHONE, "0123456789");
+ app_control_add_extra_data(request, APP_CONTROL_DATA_EMAIL, "tizen@tizen.org");
+ app_control_add_extra_data(request, APP_CONTROL_DATA_NAME, "Tizen User");
app_control_set_launch_mode(request, APP_CONTROL_LAUNCH_MODE_GROUP);
int result = app_control_send_launch_request(request, NULL, NULL);
app_control_destroy(request);
- return result;
-}
</pre>
<p>To edit a known contact, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_EDIT</span> operation with the <span style="font-family: Courier New,Courier,monospace">application/vnd.tizen.contact</span> MIME type. To specify various contact details, refer to the extras defined below.</p>
<p class="figure">Figure: Editing a contact</p>
-<p align="center"><img src="../../images/common_appcontrol_contact_edit.png" alt="Editing a contact" /></p>
+<p align="center"><img width="240" height="400" src="../../images/common_appcontrol_contact_edit.png" alt="Editing a contact" /></p>
<h4>Operation</h4>
<p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_EDIT</span></p>
+<h4>URI</h4>
+<p>N/A</p>
<h4>MIME Type (Mandatory)</h4>
<p><span style="font-family: Courier New,Courier,monospace">application/vnd.tizen.contact</span></p>
<h4>Extra Input</h4>
<tr>
<td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_PHONE</span></td>
<td>The phone number that is added to the contact. This key must be passed as a string.</td>
- <td rowspan="3">This key is optional.</td>
+ <td rowspan="3" style="vertical-align:middle">This key is optional.</td>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_EMAIL</span></td>
</table>
<h4>Example Code</h4>
<pre class="prettyprint">
-int
-launchContactEdit(const char* personId, const char *number)
-{
app_control_h request;
app_control_create(&request);
app_control_set_operation(request, APP_CONTROL_OPERATION_EDIT);
app_control_set_mime(request, "application/vnd.tizen.contact");
app_control_add_extra_data(request, APP_CONTROL_DATA_ID, personId);
-
- if (number)
- {
- app_control_add_extra_data(request, APP_CONTROL_DATA_PHONE, number);
- }
+ app_control_add_extra_data(request, APP_CONTROL_DATA_PHONE, "0987654321");
+ app_control_add_extra_data(request, APP_CONTROL_DATA_EMAIL, "2nd Email");
+
app_control_set_launch_mode(request, APP_CONTROL_LAUNCH_MODE_GROUP);
int result = app_control_send_launch_request(request, NULL, NULL);
app_control_destroy(request);
-
- return result;
-}
</pre>
<h3>Viewing a Contact</h3>
-<p>To display a specified contact in the contact database, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_VIEW</span> operation with the <span style="font-family: Courier New,Courier,monospace">application/vnd.tizen.contact</span> MIME type. To specify various contact details, refer to the extras defined below.</p>
-<p>In case of viewing a contact from a vcard file, the file path URI and <span style="font-family: Courier New,Courier,monospace">text/vcard</span> or <span style="font-family: Courier New,Courier,monospace">text/x-vcard</span> MIME type must be specified. In case of viewing a contact by a person ID, the person ID (ID in the <span style="font-family: Courier New,Courier,monospace">_contact_person</span> view) extra data and <span style="font-family: Courier New,Courier,monospace">application/vnd.tizen.contact</span> MIME type must be specified.</p>
+<p>To display a specified contact in the contact database, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_VIEW</span> operation. To specify various contact details, refer to the extras defined below.</p>
+<p>To display a specified contact from vcard file, use file: URI. To display a specified contact with person id, use application/vnd.tizen.contact MIME type with APP_CONTROL_DATA_ID.</p>
-<p class="figure">Figure: Viewing a contact</p>
-<p align="center"><img src="../../images/common_appcontrol_contact_view1.png" alt="Viewing a contact" /> <img src="../../images/common_appcontrol_contact_view2.png" alt="Viewing a contact" /></p>
+<p class="figure">Figure: Viewing a contact from ID (Left) and from v-card file (Right)</p>
+<p align="center"><img width="240" height="400" src="../../images/common_appcontrol_contact_view1.png" alt="Viewing a contact" /> <img width="240" height="400" src="../../images/common_appcontrol_contact_view2.png" alt="Viewing a contact" /></p>
<h4>Operation</h4>
<p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_VIEW</span></p>
<p><span style="font-family: Courier New,Courier,monospace">file:<path></span></p>
<h4>MIME Type</h4>
<ul>
- <li><span style="font-family: Courier New,Courier,monospace">application/vnd.tizen.contact</span></li>
+ <li><span style="font-family: Courier New,Courier,monospace">application/vnd.tizen.contact</span>
+ <p>In case of viewing a contact by a person ID, the person ID (ID in the <span style="font-family: Courier New,Courier,monospace">_contact_person</span> view) extra data and <span style="font-family: Courier New,Courier,monospace">application/vnd.tizen.contact</span> MIME type must be specified.</p>
+ </li>
<li><span style="font-family: Courier New,Courier,monospace">text/vcard</span></li>
<li><span style="font-family: Courier New,Courier,monospace">text/x-vcard</span></li>
</ul>
<p>To select a specified contact in the user's contacts, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_PICK</span> operation with the <span style="font-family: Courier New,Courier,monospace">application/vnd.tizen.contact</span> MIME type. To specify various contact details, refer to the extras defined below.</p>
<p class="figure">Figure: Selecting a contact</p>
-<p align="center"><img src="../../images/common_appcontrol_contact_select.png" alt="Selecting a contact" /></p>
+<p align="center"><img width="240" height="400" src="../../images/common_appcontrol_contact_select.png" alt="Selecting a contact" /></p>
<h4>Operation</h4>
<p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_PICK</span></p>
+<h4>URI</h4>
+<p>N/A</p>
<h4>MIME Type (Mandatory)</h4>
<p><span style="font-family: Courier New,Courier,monospace">application/vnd.tizen.contact</span></p>
<h4>Extra Input</h4>
<tr>
<td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_SELECTION_MODE</span></td>
<td>The selection mode of the PICK operation. The available values are <span style="font-family: Courier New,Courier,monospace">single</span> and <span style="font-family: Courier New,Courier,monospace">multiple</span> (<span style="font-family: Courier New,Courier,monospace">single</span> is the default, if not presented). This key must be passed as a string.</td>
- <td rowspan="3">This key is optional.</td>
+ <td rowspan="3" style="vertical-align:middle">This key is optional.</td>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_TYPE</span></td>
<td>The type of items to be delivered. The available values are <span style="font-family: Courier New,Courier,monospace">id</span>, <span style="font-family: Courier New,Courier,monospace">phone</span>, <span style="font-family: Courier New,Courier,monospace">email</span>, and <span style="font-family: Courier New,Courier,monospace">vcf</span> (<span style="font-family: Courier New,Courier,monospace">id</span> is the default, if not presented). This key must be passed as a string.</td>
</tr>
<tr>
- <td><span style="font-family: Courier New,Courier,monospace"></span>APP_CONTROL_DATA_TOTAL_COUNT</td>
+ <td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_TOTAL_COUNT</span></td>
<td>The total number of events to be returned. This key must be passed as a string.</td>
</tr>
</tbody>
}
</pre>
+<h3>Sharing a Contact</h3>
+
+<p>To share a single contact, use <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_SHARE</span> operation with MIME-type “application/vnd.tizen.contact”. To specify various contact details, refer to the extras defined below.</p>
+
+<h4>Operation</h4>
+ <p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_SHARE</span></p>
+<h4>URI</h4>
+ <p>N/A</p>
+
+<h4>MIME Type (Mandatory)</h4>
+ <p>application/vnd.tizen.contact</p>
+<h4>Extra Input</h4>
+ <table>
+ <tbody>
+ <tr>
+ <th>Key</th>
+ <th>Description</th>
+ <th>Note</th>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_ID</span></td>
+ <td>The DB record ID of the person (id in _contacts_person view) when <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_TYPE</span> is set <span style="font-family: Courier New,Courier,monospace">to <span style="font-family: Courier New,Courier,monospace">person</span>.
+ The DB record ID of the my profile (id in _contacts_my_profile view) when <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_TYPE</span> is set to <span style="font-family: Courier New,Courier,monospace">my_profile</span>. This key MUST be passed as a string.</p></td>
+ <td rowspan="2" style="vertical-align:middle">This key is mandatory.</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_TYPE</span></td>
+ <td>The type of contact. Available values are <span style="font-family: Courier New,Courier,monospace">my_profile</span> and <span style="font-family: Courier New,Courier,monospace">person</span>. This key MUST be passed as a string.</td>
+ </tr>
+ </tbody>
+ </table>
+<h4>Extra Output</h4>
+<p>N/A</p>
+<h4>Example Code</h4>
+<pre class="prettyprint">
+#include <app_control.h>
+
+app_control_h service;
+app_control_create(&service);
+
+app_control_set_operation(service, APP_CONTROL_OPERATION_SHARE);
+app_control_set_mime(service,"application/vnd.tizen.contact");
+app_control_add_extra_data(service, APP_CONTROL_DATA_TYPE, "person");
+app_control_add_extra_data(service, APP_CONTROL_DATA_ID, person_id);
+app_control_set_launch_mode(service, APP_CONTROL_LAUNCH_MODE_GROUP);
+
+app_control_send_launch_request(service, NULL, NULL);
+app_control_destroy(service);
+</pre>
+
+<h3>Sharing Multiple Contacts</h3>
+
+<p>To share a set of contacts, use <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_MULTI_SHARE</span> operation with MIME-type “application/vnd.tizen.contact”. To specify various contact details, refer to the extras defined below.</p>
+
+<h4>Operation</h4>
+ <p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_MULTI_SHARE</span></p>
+<h4>URI</h4>
+ <p>N/A</p>
+
+<h4>MIME Type (Mandatory)</h4>
+ <p>application/vnd.tizen.contact</p>
+<h4>Extra Input</h4>
+ <table>
+ <tbody>
+ <tr>
+ <th>Key</th>
+ <th>Description</th>
+ <th>Note</th>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_ID</span></td>
+ <td>The DB record IDs of the person (id in _contacts_person view). This key MUST be passed as an array.</td>
+ <td>This key is mandatory.</td>
+ </tr>
+ </tbody>
+ </table>
+<h4>Extra Output</h4>
+<p>N/A</p>
+<h4>Example Code</h4>
+<pre class="prettyprint">
+#include <app_control.h>
+char* contacts[3] = {contact1, contact2, contact3}; // contact1, contact2, contact3 is person id.
+app_control_h service;
+app_control_create(&service);
+
+app_control_set_operation(service, APP_CONTROL_OPERATION_MULTI_SHARE);
+app_control_set_mime(service,"application/vnd.tizen.contact");
+app_control_add_extra_data_array(service, APP_CONTROL_DATA_ID, contacts, 3);
+app_control_set_launch_mode(service, APP_CONTROL_LAUNCH_MODE_GROUP);
+
+app_control_send_launch_request(service, NULL, NULL);
+app_control_destroy(service);
+</pre>
+
<h2 id="email" name="email">Email</h2>
<h3>Composing an Email</h3>
-<p>To launch an email composer with optional recipients, subject, and body text, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_COMPOSE</span> operation.</p>
+<p>To compose an email with optional recipients, subject, and body text, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_COMPOSE</span> operation.</p>
<p class="figure">Figure: Composing an email</p>
<p align="center"><img src="../../images/common_appcontrol_email.png" alt="Composing an email" /></p>
<h4>Operation</h4>
<p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_COMPOSE</span></p>
-<h4>URI (Optional)</h4>
+<h4>URI (Mandatory)</h4>
<p><span style="font-family: Courier New,Courier,monospace">mailto:<email address></span></p>
<p>If the <span style="font-family: Courier New,Courier,monospace">mailto:</span> field is empty, it filters out all but email applications in the system, and you can use the extra data only to pass optional parameters.</p>
-
+<h4>MIME Type</h4>
+<p>N/A</p>
<h4>Extra Input</h4>
<table>
<tbody>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_TO</span></td>
- <td>The email address list of main recipients, separated by ";".</td>
- <td rowspan="5">This key is optional.</td>
+ <td>The Email address of main recipient(s). This key MUST be passed as an array.</td>
+ <td rowspan="5" style="vertical-align:middle">This key is optional.</td>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_CC</span></td>
- <td>The email address list of secondary (copy) recipients, separated by ";".</td>
+ <td>The Email address of recipient(s) that should be carbon copied. This key MUST be passed as an array.</td>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_BCC</span></td>
- <td>The email address list of hidden (blind copy) recipients, separated by ";".</td>
+ <td>The Email address of recipient(s) that should be blind carbon copied. This key MUST be passed as an array.</td>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_SUBJECT</span></td>
- <td>The subject of an email message. This key must be passed as a string.</td>
+ <td>The subject of an email message. This key MUST be passed as a string.</td>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_TEXT</span></td>
- <td>The body of the email to be sent. This key must be passed as a string.</td>
+ <td>The body of the email to be sent. This key MUST be passed as a string.</td>
</tr>
</tbody>
</table>
-
+<h4>Extra Output</h4>
+<p>N/A</p>
<h4>Example Code</h4>
<pre class="prettyprint">
app_control_h service;
app_control_create(&service);
+char* cc[2] = {"cc@tizen.org", "cc2@tizen.org"};
+char* bcc[2] = {"bcc@tizen.org", "bcc2@tizen.org"};
app_control_set_operation(service, APP_CONTROL_OPERATION_COMPOSE);
-app_control_add_extra_data(service, APP_CONTROL_DATA_TO, "to@test.com");
-app_control_add_extra_data(service, APP_CONTROL_DATA_CC, "cc@test.com");
-app_control_add_extra_data(service, APP_CONTROL_DATA_BCC, "bcc@test.com");
+app_control_set_uri(service, "mailto:to@tizen.org");
+app_control_add_extra_data_array(service, APP_CONTROL_DATA_CC, cc, 2);
+app_control_add_extra_data_array(service, APP_CONTROL_DATA_BCC, bcc, 2);
app_control_add_extra_data(service, APP_CONTROL_DATA_SUBJECT, "test subject");
-app_control_add_extra_data(service, APP_CONTROL_DATA_TEXT, "line1\nline2");
+app_control_add_extra_data(service, APP_CONTROL_DATA_TEXT, "line1\nline2");
-app_control_send_launch_request(service, NULL, NULL);
app_control_set_launch_mode(service, APP_CONTROL_LAUNCH_MODE_GROUP);
+app_control_send_launch_request(service, NULL, NULL);
+
app_control_destroy(service);
</pre>
-<h3>Sharing a Single File in an Email</h3>
+<h3>Sharing a Single File using an Email Message</h3>
-<p>To share a single file of nay MIME type in an email message, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_SHARE</span> operation.</p>
+<p>To share a single file of any MIME type using an email message, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_SHARE</span> operation.</p>
<p class="figure">Figure: Sharing a single file</p>
<p align="center"><img src="../../images/common_appcontrol_email2.png" alt="Sharing a single file" /></p>
<h4>Operation</h4>
<p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_SHARE</span></p>
<h4>URI (Mandatory)</h4>
- <ul><li><span style="font-family: Courier New,Courier,monospace">file:<full path to file></span> or <span style="font-family: Courier New,Courier,monospace"><full path to file></span> (no scheme)
- <p>Using a URI with the <span style="font-family: Courier New,Courier,monospace">file:</span> scheme or without any scheme is the default input for this operation. If there is such a URI, all extra data is ignored.</p></li>
+ <ul><li><span style="font-family: Courier New,Courier,monospace">file:<path></span>
<li><span style="font-family: Courier New,Courier,monospace">mailto:</span>
-<p>Only an empty <span style="font-family: Courier New,Courier,monospace">mailto:</span> field is allowed. It filters out all but email applications in the system.</p></li>
+<p>Only an empty <span style="font-family: Courier New,Courier,monospace">mailto:</span> field is allowed. This can be used to filter-out all email applications available in the system.</p></li>
</ul>
-<h4>MIME Type (Optional)</h4>
+<h4>MIME Type</h4>
<p>Any MIME type that your application needs, such as <span style="font-family: Courier New,Courier,monospace">image/jpg</span>, <span style="font-family: Courier New,Courier,monospace">video/*</span>, or <span style="font-family: Courier New,Courier,monospace">*/*</span></p>
-
+ <p>In case of sharing a single item through APP_CONTROL_DATA_PATH and URI specified with mailto:, MIME-type MUST be explicitly set. </p>
<h4>Extra Input</h4>
<table>
<tbody>
<tr>
<td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_PATH</span></td>
<td>When the URI is set to <span style="font-family: Courier New,Courier,monospace">mailto</span>, a path to a single file to be shared must be provided using this key. Otherwise, the key is ignored. This key must be passed as a string.</td>
- <td>This key is mandatory when the URI is set to <span style="font-family: Courier New,Courier,monospace">mailto</span>.</td>
+ <td>This key is mandatory when the URI is set to <span style="font-family: Courier New,Courier,monospace">mailto:</span>.</td>
</tr>
</tbody>
</table>
-
+<h4>Extra Output</h4>
+<p>N/A</p>
<h4>Example Code</h4>
<pre class="prettyprint">
#define PATH_MAX 128
app_control_set_launch_mode(service, APP_CONTROL_LAUNCH_MODE_GROUP);
app_control_set_operation(service, APP_CONTROL_OPERATION_SHARE);
app_control_set_uri(service, "mailto:");
+app_control_set_mime(service,"image/*");
app_control_add_extra_data(service, APP_CONTROL_DATA_PATH, img_path);
app_control_send_launch_request(service, NULL, NULL);
app_control_destroy(service);
</pre>
-<h3>Sharing Multiple Items in an Email</h3>
+<h3>Sharing Multiple Items using an Email Message</h3>
-<p>To share multiple files of any MIME type in an email message, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_MULTI_SHARE</span> operation.</p>
+<p>To share multiple files of any MIME type using an email message, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_MULTI_SHARE</span> operation.</p>
<p class="figure">Figure: Sharing multiple items</p>
<p align="center"><img src="../../images/common_appcontrol_email3.png" alt="Sharing multiple items" /></p>
<p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_MULTI_SHARE</span></p>
<h4>URI (Optional)</h4>
<p><span style="font-family: Courier New,Courier,monospace">mailto:</span></p>
-<p>Only an empty <span style="font-family: Courier New,Courier,monospace">mailto:</span> field is allowed. It filters out all but email applications in the system.</p>
+<p>Only an empty <span style="font-family: Courier New,Courier,monospace">mailto:</span> field is allowed. This can be used to filter-out all email applications available in the system.</p>
-<h4>MIME Type (Optional)</h4>
+<h4>MIME Type (Mandatory)</h4>
<p>Any MIME type that your application needs, such as <span style="font-family: Courier New,Courier,monospace">image/jpg</span>, <span style="font-family: Courier New,Courier,monospace">video/*</span>, or <span style="font-family: Courier New,Courier,monospace">*/*</span></p>
-
+ <p>If you try to share a set of files with different MIME types, use <type>/* or */*. For example, if you send video/mp4 and audio/ogg, the MIME type MUST be */*.</p>
<h4>Extra Input</h4>
<table>
<tbody>
</tr>
</tbody>
</table>
-
+<h4>Extra Output</h4>
+<p>N/A</p>
<h4>Example Code</h4>
<pre class="prettyprint">
#define PATH_MAX 128
app_control_set_launch_mode(service, APP_CONTROL_LAUNCH_MODE_GROUP);
app_control_set_operation(service, APP_CONTROL_OPERATION_MULTI_SHARE);
app_control_set_uri(service, "mailto:");
+app_control_set_mime(service,"image/*");
app_control_add_extra_data_array(service, APP_CONTROL_DATA_PATH, path_array, 2);
app_control_send_launch_request(service, NULL, NULL);
<h4>Operation</h4>
<p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_SHARE_TEXT</span></p>
-<h4>URI (Optional)</h4>
+<h4>URI (Mandatory)</h4>
<p><span style="font-family: Courier New,Courier,monospace">mailto:</span></p>
<p>Only an empty <span style="font-family: Courier New,Courier,monospace">mailto:</span> field is allowed. It filters out all but email applications in the system.</p>
-
+<h4>MIME Type</h4>
+<p>N/A</p>
<h4>Extra Input</h4>
<table>
<tr>
<td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_SUBJECT</span></td>
<td>The subject of an email message. This key must be passed as a string.</td>
- <td rowspan="2">This key is optional.</td>
+ <td rowspan="2" style="vertical-align:middle">This key is optional.</td>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_PATH</span></td>
- <td>The list of multiple file paths to be shared in an email message. This key must be passed as an array.</td>
+ <td>The list of multiple file paths to be shared using an email message. This key must be passed as an array.</td>
</tr>
</tbody>
</table>
app_control_destroy(service);
</pre>
+<h2 id="file" name="file">File Storage</h2>
+
+<h3>Retrieve a specific type of file</h3>
+
+<p>To select any kind of file from the storage, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_PICK</span> operation with the corresponding MIME type. To give options for pick operation, refer to the extras defined below.</p>
+<table class="note">
+ <tbody>
+ <tr>
+ <th class="note">Note</th>
+ </tr>
+ <tr>
+ <td class="note">Tizen mobile platform provides this application control by default. </td>
+ </tr>
+ </tbody>
+</table>
+<h4>Operation</h4>
+ <p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_PICK</span></p>
+<h4>URI</h4>
+<p>N/A</p>
+<h4>MIME Type (Optional)</h4>
+<p>*/*</p>
+<h4>Extra Input</h4>
+ <table>
+ <tbody>
+ <tr>
+ <th>Key</th>
+ <th>Description</th>
+ <th>Note</th>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_SELECTION_MODE</span></td>
+ <td>The selection mode of the PICK operation. The available values are <span style="font-family: Courier New,Courier,monospace">single</span> and <span style="font-family: Courier New,Courier,monospace">multiple</span> (single is the default, if not presented). This key must be passed as a string.</td>
+ <td rowspan="3" style="vertical-align:middle">This key is optional</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_TOTAL_COUNT</span></td>
+ <td>The total number of items to be returned. This key must be passed as a string.</td>
+
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_TOTAL_SIZE</span></td>
+ <td>The total size of items to be returned in bytes. This key must be passed as a string.</td>
+
+ </tr>
+ </tbody>
+ </table>
+
+<h4>Extra Output</h4>
+ <table>
+ <tbody>
+ <tr>
+ <th>Key</th>
+ <th>Value Description</th>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_SELECTED</span></td>
+ <td>The list of selected file paths. This key must be passed as an array.</td>
+ </tr>
+ </tbody>
+ </table>
+<h4>Example Code</h4>
+<pre class="prettyprint">
+#include <app_control.h>
+
+app_control_h service;
+app_control_create(&service);
+
+app_control_set_operation(service, APP_CONTROL_OPERATION_PICK);
+app_control_add_extra_data(service, APP_CONTROL_ SELECTION_MODE, "single");
+app_control_set_launch_mode(service, APP_CONTROL_LAUNCH_MODE_GROUP);
+
+app_control_send_launch_request(service, NULL, NULL);
+</pre>
+
+<h3>Download a file</h3>
+
+<p>To download a file, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_DOWNLOAD</span> operation and specify the URL in the URI.</p>
+<h4>Operation</h4>
+ <p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_DOWNLOAD</span></p>
+ <p>To request this operation, the http://tizen.org/privilege/download privilege is needed since 2.4</p>
+<h4>URI</h4>
+ <ul>
+ <li>http:<path></li>
+ <li>https:<path></li>
+ </ul>
+<h4>MIME Type</h4>
+ <p>N/A</p>
+<h4>Extra Input</h4>
+ <p>N/A</p>
+<h4>Extra Output</h4>
+ <p>N/A</p>
+<h4>Example Code</h4>
+<pre class="prettyprint">
+app_control_h app_control;
+app_control_create(&app_control);
+app_control_set_operation(app_control, APP_CONTROL_OPERATION_DOWNLOAD);
+app_control_set_uri(app_control, "http://PATH_TO_FILE");
+app_control_send_launch_request(app_control, NULL, NULL);
+app_control_destroy(app_control);
+
+</pre>
+
+
+
<h2 id="map" name="map">Map</h2>
<h3>Showing a Location on a Map</h3>
<ul><li><span style="font-family: Courier New,Courier,monospace">geo:latitude,longitude</span>
<p>Show the map with 2 values that represent the latitude and longitude. For example: <span style="font-family: Courier New,Courier,monospace">geo:50.1,-50.1</span></p></li>
<li><span style="font-family: Courier New,Courier,monospace">geo:0,0?q=keyword</span>
- <p>Show the map at the location of a given keyword (address or POI). For example: <span style="font-family: Courier New,Courier,monospace">geo:0,0?q="Eiffel Tower"</span></p></li>
+ <p>Show the map at the location of a given keyword (address or POI). For example: <span style="font-family: Courier New,Courier,monospace">geo:0,0?q=Eiffel%20Tower</span></p><br>
+ <p>All strings passed in the geo: URI must be encoded.</p></li>
</ul>
+<h4>MIME Type</h4>
+<p>N/A</p>
<h4>Extra Input</h4>
- <table>
- <tbody>
- <tr>
- <th>Key</th>
- <th>Description</th>
- <th>Note</th>
- </tr>
- <tr>
- <td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_TYPE</span></td>
- <td>The type of the keyword, in case the URI contains a keyword. The available values are <span style="font-family: Courier New,Courier,monospace">address</span> and <span style="font-family: Courier New,Courier,monospace">poi</span> (<span style="font-family: Courier New,Courier,monospace">poi</span> is the default, if not presented).</td>
- <td>This key is mandatory only when the location URI is given as a keyword.</td>
- </tr>
- </tbody>
- </table>
-
+<p>N/A</p>
+<h4>Extra Output</h4>
+<p>N/A</p>
<h4>Example Code</h4>
<pre class="prettyprint">
#include <app_control.h>
<h4>Operation</h4>
<p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_PICK</span></p>
-<h4>URI (Optional)</h4>
-<p><span style="font-family: Courier New,Courier,monospace">geo:0,0?q=keyword</span></p>
- <p>Show the map at the location of a given keyword (address or POI). For example: <span style="font-family: Courier New,Courier,monospace">geo:0,0?q="Eiffel Tower"</span></p>
+<h4>URI (Mandatory)</h4>
+ <ul><li><span style="font-family: Courier New,Courier,monospace">geo:0,0?q=keyword</span>
+ <p>If only "geo:" is used, it filters out all but map applications in the system, and you can use the extra data only to pass optional parameters.</p><br/>
+ <p>Show the map at the location of a given keyword (address or POI). For example: <span style="font-family: Courier New,Courier,monospace">geo:0,0?q=Eiffel%20Tower</span></p>
+ <p>All strings passed in the geo: URI must be encoded.</p></li>
+ </ul>
+<h4>MIME Type</h4>
+<p>N/A</p>
<h4>Extra Input</h4>
<table>
<tbody>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_TYPE</span></td>
- <td>The type of the keyword. The available values are <span style="font-family: Courier New,Courier,monospace">address</span> and <span style="font-family: Courier New,Courier,monospace">poi</span> (<span style="font-family: Courier New,Courier,monospace">poi</span> is the default, if not presented).</td>
+ <td>The type of items to be delivered. Available values are <span style="font-family: Courier New,Courier,monospace">address</span>, <span style="font-family: Courier New,Courier,monospace">image</span>, or <span style="font-family: Courier New,Courier,monospace">all</span> (<span style="font-family: Courier New,Courier,monospace">address</span> is default if not presented). This key MUST be passed as a string.</td>
<td>This key is optional.</td>
</tr>
</tbody>
<p>To compose a new message, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_COMPOSE</span> operation. To specify various message details, refer to the extras defined below.</p>
<p class="figure">Figure: Composing a message</p>
-<p align="center"><img src="../../images/common_appcontrol_message.png" alt="Composing a message" /></p>
+<p align="center"><img width="240" hegith="400" src="../../images/common_appcontrol_message.png" alt="Composing a message" /></p>
<h4>Operation</h4>
<p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_COMPOSE</span></p>
-<h4>URI (Optional)</h4>
+<h4>URI (Mandatory)</h4>
<ul><li><span style="font-family: Courier New,Courier,monospace">sms:<phone-number></span>
<p>For example: <span style="font-family: Courier New,Courier,monospace">sms:+17913331234</span></p></li>
<li><span style="font-family: Courier New,Courier,monospace">mmsto:<phone-number></span>
<p>For example: <span style="font-family: Courier New,Courier,monospace">mmsto:+17913331234</span></p></li>
</ul>
+<h4>MIME Type</h4>
+<p>N/A</p>
<h4>Extra Input</h4>
<table>
<tbody>
<tr>
<td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_TO</span></td>
<td>The phone numbers of recipients. This key must be passed as an array.</td>
- <td rowspan="3">This key is optional.</td>
+ <td rowspan="3" style="vertical-align:middle">This key is optional.</td>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_TEXT</span></td>
</tr>
</tbody>
</table>
-
+<h4>Extra Output</h4>
+<p>N/A</p>
<h4>Example Code</h4>
<pre class="prettyprint">
#include <app_control.h>
app_control_create(&service);
app_control_set_operation(service, APP_CONTROL_OPERATION_COMPOSE);
-app_control_set_uri(service, "sms:123456789");
+app_control_set_uri(service, "mmsto:1234567890");
app_control_set_launch_mode(service, APP_CONTROL_LAUNCH_MODE_GROUP);
+app_control_add_extra_data(service,APP_CONTROL_DATA_TEXT,"My text");
+app_control_add_extra_data(service,APP_CONTROL_DATA_SUBJECT,"My subject");
app_control_send_launch_request(service, NULL, NULL);
</pre>
-<h3>Sharing a Single Item in a Message</h3>
+<h3>Sharing a Single Item using a Message</h3>
-<p>To share a single file in an MMS message, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_SHARE</span> operation.</p>
+<p>To share a single item using an MMS message, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_SHARE</span> operation.</p>
<p class="figure">Figure: Sharing a single item</p>
-<p align="center"><img src="../../images/common_appcontrol_message2.png" alt="Sharing a single item" /></p>
+<p align="center"><img width="240" height="400" src="../../images/common_appcontrol_message2.png" alt="Sharing a single item" /></p>
<h4>Operation</h4>
<p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_SHARE</span></p>
<h4>URI (Mandatory)</h4>
- <ul><li><span style="font-family: Courier New,Courier,monospace">mmsto:<phone-number></span>
- <p>For example: <span style="font-family: Courier New,Courier,monospace">mmsto:+17913331234</span></p></li>
+ <ul><li><span style="font-family: Courier New,Courier,monospace">mmsto:</span>
+ <p>Only an empty mmsto: field is allowed. This can be used to filter-out all message applications available in the system.</p>
<li><span style="font-family: Courier New,Courier,monospace">file:<path></span>
<p>For example: <span style="font-family: Courier New,Courier,monospace">file://<media storage path>/item.jpg</span></p></li>
</ul>
-<h4>MIME Type (Optional)</h4>
+<h4>MIME Type</h4>
<p>Any MIME type that your application needs, such as <span style="font-family: Courier New,Courier,monospace">image/jpg</span>, <span style="font-family: Courier New,Courier,monospace">video/*</span>, or <span style="font-family: Courier New,Courier,monospace">*/*</span></p>
-
+ <p>In case of sharing a single item through APP_CONTROL_DATA_PATH and URI specified with mmsto, MIME-type MUST be explicitly set. </p>
<h4>Extra Input</h4>
<table>
<tbody>
</tr>
</tbody>
</table>
-
+<h4>Extra Output</h4>
+<p>N/A</p>
<h4>Example Code</h4>
<pre class="prettyprint">
#include <app_control.h>
app_control_send_launch_request(service, NULL, NULL);
</pre>
-<h3>Sharing Multiple Items in a Message</h3>
+<h3>Sharing Multiple Items using a Message</h3>
-<p>To share multiple files in an MMS message, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_MULTI_SHARE</span> operation.</p>
+<p>To share multiple items using an MMS message, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_MULTI_SHARE</span> operation.</p>
<p class="figure">Figure: Sharing multiple items</p>
<p align="center"><img src="../../images/common_appcontrol_message3.png" alt="Sharing multiple items" /></p>
<h4>Operation</h4>
<p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_MULTI_SHARE</span></p>
<h4>URI (Optional)</h4>
-<p><span style="font-family: Courier New,Courier,monospace">mmsto:<phone-number></span></p>
- <p>For example: <span style="font-family: Courier New,Courier,monospace">mmsto:+17913331234</span></p>
+<p><span style="font-family: Courier New,Courier,monospace">mmsto:</span></p>
+ <p><p>Only an empty mmsto: field is allowed. This can be used to filter-out all message applications available in the system.</p></p>
-<h4>MIME Type (Optional)</h4>
+<h4>MIME Type (Mandatory)</h4>
<p>Any MIME type that your application needs, such as <span style="font-family: Courier New,Courier,monospace">image/jpg</span>, <span style="font-family: Courier New,Courier,monospace">video/*</span>, or <span style="font-family: Courier New,Courier,monospace">*/*</span></p>
-
+ <p>If you try to share a set of files with different MIME types, use <type>/* or */*. For example, if you send video/mp4 and audio/ogg, the MIME type MUST be */*.</p>
<h4>Extra Input</h4>
<table>
<tbody>
</tr>
</tbody>
</table>
-
+<h4>Extra Output</h4>
+<p>N/A</p>
<h4>Example Code</h4>
<pre class="prettyprint">
#include <app_control.h>
const char* paths[] = {IMAGE_PATH1,IMAGE_PATH2};
app_control_set_operation(service, APP_CONTROL_OPERATION_MULTI_SHARE);
+app_control_set_uri(service,"mmsto:");
app_control_add_extra_data_array(service, APP_CONTROL_DATA_PATH, paths, 2);
app_control_set_launch_mode(service, APP_CONTROL_LAUNCH_MODE_GROUP);
<p>To share any text with an SMS or MSM message, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_SHARE_TEXT</span> operation.</p>
<p class="figure">Figure: Sharing text</p>
-<p align="center"><img src="../../images/common_appcontrol_message4.png" alt="Sharing text" /></p>
+<p align="center"><img width="240" height="400" src="../../images/common_appcontrol_message4.png" alt="Sharing text" /></p>
<h4>Operation</h4>
<p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_SHARE_TEXT</span></p>
-<h4>URI (Optional)</h4>
- <ul><li><span style="font-family: Courier New,Courier,monospace">sms:<phone-number></span>
- <p>For example: <span style="font-family: Courier New,Courier,monospace">sms:+17913331234</span></p></li>
- <li><span style="font-family: Courier New,Courier,monospace">mmsto:<phone-number></span>
- <p>For example: <span style="font-family: Courier New,Courier,monospace">mmsto:+17913331234</span></p></li>
+<h4>URI (Mandatory)</h4>
+ <ul><li><span style="font-family: Courier New,Courier,monospace">sms:</span></li>
+ <li><span style="font-family: Courier New,Courier,monospace">mmsto:</span></li>
+ <p>Only an empty sms: or mmsto: field is allowed. This can be used to filter-out all message applications available in the system.</p></li>
</ul>
<tr>
<td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_SUBJECT</span></td>
<td>The subject of an MMS message. If it is set for an SMS message, the message is automatically converted to MMS. This key must be passed as a string.</td>
- <td rowspan="2">This key is optional.</td>
+ <td rowspan="2" style="vertical-align:middle">This key is optional.</td>
</tr>
<tr>
<td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_PATH</span></td>
app_control_create(&service);
app_control_set_operation(service, APP_CONTROL_OPERATION_SHARE_TEXT);
-app_control_add_extra_data(service, APP_CONTROL_DATA_TEXT, "How are you?");
-app_control_add_extra_data(service, APP_CONTROL_DATA_SUBJECT, "Hi");
+app_control_set_uri(service,"mmsto:");
+app_control_add_extra_data(service, APP_CONTROL_DATA_TEXT, "Hello, My name is Tizy.");
+app_control_add_extra_data(service, APP_CONTROL_DATA_SUBJECT, "My subject");
app_control_set_launch_mode(service, APP_CONTROL_LAUNCH_MODE_GROUP);
app_control_send_launch_request(service, NULL, NULL);
</pre>
+<h2 id="multimedia" name="multimedia">Multimedia</h2>
+<h3>Play an audio/video file</h3>
+<p> You can play an audio/video file by using <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_VIEW</span> operation with an URI. URI and MIME type are defined below.
+<table class="note">
+ <tbody>
+ <tr>
+ <th class="note">Note</th>
+ </tr>
+ <tr>
+ <td class="note">Tizen mobile platform provides this application control by default. </td>
+ </tr>
+ </tbody>
+</table>
+<h4>Operation</h4>
+ <p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_VIEW</span></p>
+<h4>URI (Mandatory)</h4>
+ <ul>
+ <li><span style="font-family: Courier New,Courier,monospace">http:<path></span>
+ <li><span style="font-family: Courier New,Courier,monospace">https:<path></span>
+ <li><span style="font-family: Courier New,Courier,monospace">file:<path></span>
+ <li><span style="font-family: Courier New,Courier,monospace">rtsp:<path></span>
+ <li><span style="font-family: Courier New,Courier,monospace">rtp:<path></span>
+ </ul>
+
+<h4>MIME Type (Optional)</h4>
+ <ul>
+ <li><span style="font-family: Courier New,Courier,monospace">audio/*</span>
+ <li><span style="font-family: Courier New,Courier,monospace">video/*</span>
+ <li><span style="font-family: Courier New,Courier,monospace">text/x-iMelody</span>
+ <li><span style="font-family: Courier New,Courier,monospace">application/vnd.apple.mpegurl</span>
+ <li><span style="font-family: Courier New,Courier,monospace">application/x-mpegurl</span>
+ <li><span style="font-family: Courier New,Courier,monospace">application/sdp</span>
+ <li><span style="font-family: Courier New,Courier,monospace">application/ogg</span>
+ <li><span style="font-family: Courier New,Courier,monospace">application/x-smaf</span>
+ <li><span style="font-family: Courier New,Courier,monospace">application/vnd.smaf</span>
+ </ul>
+
+<h4> Extra Input</h4>
+<p>N/A</p>
+<h4> Extra Output</h4>
+<p>N/A</p>
+<h4>Example Code</h4>
+<pre class="prettyprint">
+#include <app_control.h>
+#include <dlog.h>
+
+int play_audio_operation(const char* audio_uri)
+{
+ int ret = 0;
+
+ app_control_h service = NULL;
+ app_control_create(&service);
+
+ if (service == NULL)
+ {
+ dlog_print(DLOG_INFO, LOG_TAG, "service_create failed!\n");
+ return -1;
+ }
+
+ app_control_set_operation(service, APP_CONTROL_OPERATION_VIEW);
+ app_control_set_uri(service, audio_uri);
+ ret = app_control_send_launch_request(service, NULL, NULL);
+ app_control_destroy(service);
+
+ if (ret == APP_CONTROL_ERROR_NONE)
+ {
+ dlog_print(DLOG_INFO, LOG_TAG, "Succeeded to request!\n");
+ return 0;
+ }
+ else
+ {
+ dlog_print(DLOG_INFO, LOG_TAG, "Failed to request!\n");
+ return -1;
+ }
+
+ return 0;
+}
+
+</pre>
+
+<h3>View an image file</h3>
+<p> You can display an image file by using <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_VIEW</span> operation with an URI. URI and MIME type are defined below.</p>
+<table class="note">
+ <tbody>
+ <tr>
+ <th class="note">Note</th>
+ </tr>
+ <tr>
+ <td class="note">Tizen mobile platform provides this application control by default. </td>
+ </tr>
+ </tbody>
+</table>
+<h4>Operation</h4>
+ <p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_VIEW</span></p>
+<h4>URI (Mandatory)</h4>
+ <ul>
+ <li><span style="font-family: Courier New,Courier,monospace">http:<path></span>
+ <li><span style="font-family: Courier New,Courier,monospace">https:<path></span>
+ <li><span style="font-family: Courier New,Courier,monospace">file:<path></span>
+ </ul>
+
+<h4>MIME Type (Optional)</h4>
+ <ul>
+ <li><span style="font-family: Courier New,Courier,monospace">image/*</span>
+ </ul>
+
+<h4> Extra Input</h4>
+<p>N/A</p>
+<h4> Extra Output</h4>
+<p>N/A</p>
+<h4>Example Code</h4>
+<pre class="prettyprint">
+#include <app_control.h>
+#include <dlog.h>
+
+int view_image_operation(const char* image_uri)
+{
+ int ret = 0;
+
+ app_control_h service = NULL;
+ app_control_create(&service);
+
+ if (service == NULL)
+ {
+ dlog_print(DLOG_INFO, LOG_TAG, "service_create failed!\n");
+ return -1;
+ }
+
+ app_control_set_operation(service, APP_CONTROL_OPERATION_VIEW);
+ app_control_set_uri(service, image_uri);
+ ret = app_control_send_launch_request(service, NULL, NULL);
+ app_control_destroy(service);
+
+ if (ret == APP_CONTROL_ERROR_NONE)
+ {
+ dlog_print(DLOG_INFO, LOG_TAG, "Succeeded to request!\n");
+ return 0;
+ }
+ else
+ {
+ dlog_print(DLOG_INFO, LOG_TAG, "Failed to request!\n");
+ return -1;
+ }
+
+ return 0;
+}
+</pre>
+
+
+<h3>Retrieve a media file</h3>
+<p> You can retrieve a specific type of media file by using <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_PICK</span> operation. URI, MIME type, and extra for input and output are defined below.</p>
+<table class="note">
+ <tbody>
+ <tr>
+ <th class="note">Note</th>
+ </tr>
+ <tr>
+ <td class="note">Tizen mobile platform provides this application control by default. </td>
+ </tr>
+ </tbody>
+</table>
+<h4>Operation</h4>
+ <p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_PICK</span></p>
+<h4>URI</h4>
+<p>N/A</p>
+
+<h4>MIME Type (Optional)</h4>
+ <ul>
+ <li><span style="font-family: Courier New,Courier,monospace">audio/*</span></li>
+ <li><span style="font-family: Courier New,Courier,monospace">image/*</span></li>
+ <li><span style="font-family: Courier New,Courier,monospace">video/*</span></li>
+ </ul>
+
+<h4>Extra Input</h4>
+ <table>
+ <tbody>
+ <tr>
+ <th>Key</th>
+ <th>Description</th>
+ <th>Note</th>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_SELECTION_MODE</span></td>
+ <td>The selection mode of the PICK operation. The available values are <span style="font-family: Courier New,Courier,monospace">single</span> and <span style="font-family: Courier New,Courier,monospace">multiple</span> (single is the default, if not presented). This key must be passed as a string.</td>
+ <td>This key is optional</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_TOTAL_COUNT</span></td>
+ <td>The total number of items to be returned. This key must be passed as a string.</td>
+ <td>This key is optional</td>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_TOTAL_SIZE</span></td>
+ <td>The total size of items to be returned in bytes. This key must be passed as a string.</td>
+ <td>This key is optional</td>
+ </tr>
+ </tbody>
+ </table>
+
+<h4>Extra Output</h4>
+ <table>
+ <tbody>
+ <tr>
+ <th>Key</th>
+ <th>Value Description</th>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_SELECTED</span></td>
+ <td>The path(s) of the selected file(s). This key must be passed as an array.</td>
+ </tr>
+ </tbody>
+ </table>
+<h4>Example Code</h4>
+<pre class="prettyprint">
+#include <app_control.h>
+#include <dlog.h>
+
+int retrieve_media_operation(const char* mime_type)
+{
+ int ret = 0;
+
+ app_control_h service = NULL;
+ app_control_create(&service);
+
+ if (service == NULL)
+ {
+ dlog_print(DLOG_INFO, LOG_TAG, "service_create failed!\n");
+ return -1;
+ }
+
+ app_control_set_operation(service, APP_CONTROL_OPERATION_PICK);
+ app_control_set_mime(service, mime_type);
+ ret = app_control_send_launch_request(service, NULL, NULL);
+ app_control_destroy(service);
+
+ if (ret == APP_CONTROL_ERROR_NONE)
+ {
+ dlog_print(DLOG_INFO, LOG_TAG, "Succeeded to request!\n");
+ return 0;
+ }
+ else
+ {
+ dlog_print(DLOG_INFO, LOG_TAG, "Failed to request!\n");
+ return -1;
+ }
+
+ return 0;
+}
+
+</pre>
+
+
+<h2 id="settings_main" name="settings_main">System Settings</h2>
+
+<h3>Showing System Settings</h3>
+
+<p>To display various setting menus for, for example, Connections, Devices, and System Information, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_SETTING</span> operation.</p>
+<p class="figure">Figure: Showing system settings</p>
+<p align="center"><img width="240" height="400" src="../../images/common_appcontrol_system_setting.png" alt="Showing system settings" /></p>
+
+<h4>Operation</h4>
+ <p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_SETTING</span></p>
+<h4>URI</h4>
+<p>N/A</p>
+<h4>MIME Type</h4>
+<p>N/A</p>
+<h4>Extra Input</h4>
+<p>N/A</p>
+<h4>Extra Output</h4>
+<p>N/A</p>
+<h4>Example Code</h4>
+<pre class="prettyprint">
+int
+launch_setting(void)
+{
+ int ret = 0;
+ app_control_h service = NULL;
+ app_control_create(&service);
+
+ if (service == NULL)
+ {
+ dlog_print(DLOG_INFO, LOG_TAG, "Failed to create app control handler");
+
+ return -1;
+ }
+
+ app_control_set_operation(service, APP_CONTROL_OPERATION_SETTING);
+
+ ret = app_control_send_launch_request(service, NULL, NULL);
+ app_control_destroy(service);
+
+ if (ret == APP_CONTROL_ERROR_NONE)
+ {
+ dlog_print(DLOG_INFO, LOG_TAG, "Succeeded to launch settings!\n");
+
+ return 0;
+ }
+ else
+ {
+ dlog_print(DLOG_INFO, LOG_TAG, "Failed to launch settings!\\n");
+
+ return -1;
+ }
+
+ return 0;
+}
+</pre>
+
<h2 id="settings_bluetooth" name="settings_bluetooth">Settings for Bluetooth</h2>
<h3>Showing Bluetooth Settings to Activate Bluetooth</h3>
<p>To launch the Bluetooth setting application to allow the user to activate or deactivate Bluetooth, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_SETTING_BT_ENABLE</span> operation.</p>
<p class="figure">Figure: Showing Bluetooth activation settings</p>
-<p align="center"><img src="../../images/common_appcontrol_system_bluetooth.png" alt="Showing Bluetooth activation settings" /></p>
+<p align="center"><img width="240" height="400" src="../../images/common_appcontrol_system_bluetooth.png" alt="Showing Bluetooth activation settings" /> <img width="240" height="400" src="../../images/common_appcontrol_system_bluetooth2.png" alt="Showing Bluetooth activation settings" /></p>
<h4>Operation</h4>
<p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_SETTING_BT_ENABLE</span></p>
-
+<h4>URI</h4>
+<p>N/A</p>
+<h4>MIME Type</h4>
+<p>N/A</p>
+<h4>Extra Input</h4>
+<p>N/A</p>
+<h4>Extra Output</h4>
+<p>N/A</p>
<h4>Example Code</h4>
<pre class="prettyprint">
<p>To launch the Bluetooth setting application to allow the user to configure the visibility of the device, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_SETTING_BT_VISIBILITY</span> operation.</p>
-<p align="center"><img src="../../images/common_appcontrol_system_bluetooth2.png" alt="Showing location settings" /></p>
+<p align="center"><img width="240" height="400" src="../../images/common_appcontrol_system_bluetooth_visibility.png" alt="Showing location settings" /></p>
<h4>Operation</h4>
<p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_SETTING_BT_VISIBILITY</span></p>
-
+<h4>URI</h4>
+<p>N/A</p>
+<h4>MIME Type</h4>
+<p>N/A</p>
+<h4>Extra Input</h4>
+<p>N/A</p>
+<h4>Extra Output</h4>
+<p>N/A</p>
<h4>Example Code</h4>
<pre class="prettyprint">
<p>To launch the location setting application to allow the user to configure the source of the location information, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_SETTING_LOCATION</span> operation.</p>
<p>If the location service is not active when an application tries to use the Location Manager (in <a href="../../../../org.tizen.native.mobile.apireference/group__CAPI__LOCATION__MANAGER__MODULE.html">mobile</a> or <a href="../../../../org.tizen.native.wearable.apireference/group__CAPI__LOCATION__MANAGER__MODULE.html">wearable</a> applications) or Geolocation APIs, an error occurs. To solve the problem, the application can try to launch the location setting application to let the user enable the location service. The user can activate the GPS, network positioning using the Wi-Fi Positioning System (WPS) and cellular network, or both.</p>
<p class="figure">Figure: Showing location settings</p>
-<p align="center"><img src="../../images/common_appcontrol_system_location.png" alt="Showing location settings" /></p>
+<p align="center"><img width="240" height="400" src="../../images/common_appcontrol_system_location.png" alt="Showing location settings" /> <img width="240" height="400" src="../../images/common_appcontrol_system_location2.png" alt="Showing location settings" /></p>
<h4>Operation</h4>
<p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_SETTING_LOCATION</span></p>
-
+<h4>URI</h4>
+<p>N/A</p>
+<h4>MIME Type</h4>
+<p>N/A</p>
+<h4>Extra Input</h4>
+<p>N/A</p>
+<h4>Extra Output</h4>
+<p>N/A</p>
<h4>Example Code</h4>
<pre class="prettyprint">
<p>To launch the NFC setting application to allow the user to activate or deactivate NFC, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_SETTING_NFC</span> operation.</p>
<p class="figure">Figure: Showing NFC settings</p>
-<p align="center"><img src="../../images/common_appcontrol_system_nfc.png" alt="Showing NFC settings" /></p>
+<p align="center"><img width = "450" height="400" src="../../images/common_appcontrol_system_nfc.png" alt="Showing NFC settings" /></p>
<h4>Operation</h4>
<p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_SETTING_NFC</span></p>
-
+<h4>URI</h4>
+<p>N/A</p>
+<h4>MIME Type</h4>
+<p>N/A</p>
+<h4>Extra Input</h4>
+<p>N/A</p>
+<h4>Extra Output</h4>
+<p>N/A</p>
<h4>Example Code</h4>
<pre class="prettyprint">
<p>To launch the Wi-Fi setting application to allow the user to activate and configure (or deactivate) Wi-Fi connections, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_SETTING_WIFI</span> operation.</p>
<p class="figure">Figure: Showing Wi-Fi settings</p>
-<p align="center"><img src="../../images/common_appcontrol_system_wifi.png" alt="Showing Wi-Fi settings" /></p>
+<p align="center"><img widt="240" height="400" src="../../images/common_appcontrol_system_wifi.png" alt="Showing Wi-Fi settings" /></p>
<h4>Operation</h4>
<p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_SETTING_WIFI</span></p>
-
+<h4>URI</h4>
+<p>N/A</p>
+<h4>MIME Type</h4>
+<p>N/A</p>
+<h4>Extra Input</h4>
+<p>N/A</p>
+<h4>Extra Output</h4>
+<p>N/A</p>
<h4>Example Code</h4>
<pre class="prettyprint">
}
</pre>
-<h2 id="settings_main" name="settings_main">System Settings</h2>
+<h2 id="voice" name="voice">Voice Recorder</h2>
-<h3>Showing System Settings</h3>
+<h3>Record audio</h3>
-<p>To display various setting menus for, for example, Connections, Devices, and System Information, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_SETTING</span> operation.</p>
-<p class="figure">Figure: Showing system settings</p>
-<p align="center"><img src="../../images/common_appcontrol_system_setting.png" alt="Showing system settings" /></p>
+<p>To record audio, use the <span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_CREATE_CONTENT</span> operation with the audio MIME type. To give an option for recording audio, refer to the extras defined below.</p>
<h4>Operation</h4>
- <p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_SETTING</span></p>
+<p><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_OPERATION_CREATE_CONTENT</span></p>
+<h4>URI</h4>
+<p>N/A</p>
-<h4>Example Code</h4>
-<pre class="prettyprint">
-int
-launch_setting(void)
-{
- int ret = 0;
- app_control_h service = NULL;
- app_control_create(&service);
-
- if (service == NULL)
- {
- dlog_print(DLOG_INFO, LOG_TAG, "Failed to create app control handler");
-
- return -1;
- }
-
- app_control_set_operation(service, APP_CONTROL_OPERATION_SETTING);
-
- ret = app_control_send_launch_request(service, NULL, NULL);
- app_control_destroy(service);
-
- if (ret == APP_CONTROL_ERROR_NONE)
- {
- dlog_print(DLOG_INFO, LOG_TAG, "Succeeded to launch settings!\n");
-
- return 0;
- }
- else
- {
- dlog_print(DLOG_INFO, LOG_TAG, "Failed to launch settings!\\n");
+<h4>MIME Type (Mandatory)</h4>
+<p>Audio MIME-type such as audio/m4a, audio/ogg, and audio/*</p>
- return -1;
- }
+<h4>Extra Input</h4>
+ <table>
+ <tbody>
+ <tr>
+ <th>Key</th>
+ <th>Description</th>
+ <th>Note</th>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_TOTAL_SIZE</span></td>
+ <td>The total size of items to be returned in bytes. This key must be passed as a string.</td>
+ <td>This key is optional</td>
+ </tr>
+ </tbody>
+ </table>
- return 0;
-}
-</pre>
+<h4>Extra Output</h4>
+ <table>
+ <tbody>
+ <tr>
+ <th>Key</th>
+ <th>Value Description</th>
+ </tr>
+ <tr>
+ <td><span style="font-family: Courier New,Courier,monospace">APP_CONTROL_DATA_SELECTED</span></td>
+ <td>The path of the created audio file. This key must be passed as a string.</td>
+ </tr>
+ </tbody>
+ </table>
+
+<pre class="prettyprint">
+#include <app_control.h>
+app_control_h service;
+app_control_create(&service);
+app_control_set_operation(service, APP_CONTROL_OPERATION_CREATE_CONTENT);
+app_control_set_mime(service, “audio/m4a”);
+app_control_set_launch_mode(service, APP_CONTROL_LAUNCH_MODE_GROUP);
+app_control_send_launch_request(service, NULL, NULL);
+</pre>
<script type="text/javascript" src="../../scripts/jquery.zclip.min.js"></script>
projects / sdk / online-doc.git / commitdiff
