</tr>
<tr>
<td class="note">The Application API is mandatory for both Tizen mobile and wearable profiles, which means that it is supported in all mobile and wearable devices.
- <p>All mandatory APIs are supported on the Tizen Emulators.</p></td>
+ <p>All mandatory APIs are supported on the Tizen Emulators.</p>
+ </td>
</tr>
</tbody>
</table>
<p>The provider application calls the <span style="font-family: Courier New,Courier,monospace">getRequestedAppControl()</span> method of the <span style="font-family: Courier New,Courier,monospace">Application</span> interface to get the reference of the <span style="font-family: Courier New,Courier,monospace">RequestedApplicationControl</span> object containing the application control passed by the <span style="font-family: Courier New,Courier,monospace">launchAppControl()</span> method from the calling application. Then, the provider application calls either the <span style="font-family: Courier New,Courier,monospace">replyResult()</span> method (in case of success) or the <span style="font-family: Courier New,Courier,monospace">replyFailure()</span> method (in case of failure) of the <span style="font-family: Courier New,Courier,monospace">RequestedApplicationControl</span> interface to return the control back to the requesting application. The result of the provided operation (if any), is delivered as an array of <span style="font-family: Courier New,Courier,monospace">ApplicationControlData</span> objects (in <a href="../../../../../org.tizen.web.apireference/html/device_api/mobile/tizen/application.html#ApplicationControlData">mobile</a> and <a href="../../../../../org.tizen.web.apireference/html/device_api/wearable/tizen/application.html#ApplicationControlData">wearable</a> applications). The result is received in the original calling application through the <span style="font-family: Courier New,Courier,monospace">ApplicationControlDataArrayReplyCallback</span> event handler (in <a href="../../../../../org.tizen.web.apireference/html/device_api/mobile/tizen/application.html#ApplicationControlDataArrayReplyCallback">mobile</a> and <a href="../../../../../org.tizen.web.apireference/html/device_api/wearable/tizen/application.html#ApplicationControlDataArrayReplyCallback">wearable</a> applications). </p>
<p>The application control uses the following primary information:</p>
<ul><li>Application ID
-<p>Used to identify the provider application of the requested application control. Besides the application ID, a <a href="#platform_appcontrol">platform-defined application control</a> has a special alias name for the application ID with the prefix <span style="font-family: Courier New,Courier,monospace">tizen</span>. For example, the platform phone application has the alias application ID of <span style="font-family: Courier New,Courier,monospace">tizen.phone</span>.</p></li>
+<p>Used to identify the provider application of the requested application control. Besides the application ID, a <a href="#platform_appcontrol">platform-defined application control</a> has a special alias name for the application ID with the prefix <span style="font-family: Courier New,Courier,monospace">tizen</span>. For example, the platform phone application has the alias application ID of <span style="font-family: Courier New,Courier,monospace">tizen.phone</span>.</p>
+<p><font color="red">Tizen Alias ID is deprecated since Tizen 2.3.1.</font></p></li>
<li>Operation
<p>Describes an action to be performed by the provider application. The operation ID of the platform-provided operation is in the <span style="font-family: Courier New,Courier,monospace">http://tizen.org/appcontrol/operation/<verb></span> format. For example, <span style="font-family: Courier New,Courier,monospace">http://tizen.org/appcontrol/operation/view</span>.
<p>The browsing a Web page application control service allows you to display Web pages in your own application using the device's Web browser.</p>
<h5 id="appid_browse" name="appid_browse">Application ID</h5>
<p>This application control can be accessed using aliased application ID of "<span style="font-family: Courier New,Courier,monospace">tizen.internet</span>".</p>
+ <p><font color="red">Tizen Alias ID is deprecated since Tizen 2.3.1.</font></p>
<h5 id="operation_browse" name="operation_browse">VIEW Operation</h5>
<p>This application control supports the <span style="font-family: Courier New,Courier,monospace">http://tizen.org/appcontrol/operation/view</span> operation only.</p>
<p>This operation launches a Web browser and displays a specific Web page. The device user can access other Web pages, manage bookmarks, search for text on the Web page, and modify brightness and Internet settings. If the Internet connection is not available or if the specified Web page does not exist, an error message is displayed.</p>
var appControl = new tizen.ApplicationControl("http://tizen.org/appcontrol/operation/view",
"http://www.tizen.org", null, null);
-tizen.application.launchAppControl(appControl, "tizen.internet",
+tizen.application.launchAppControl(appControl, "tizen.internet",
function() {console.log("launch application control succeed");},
function(e) {/* Error handling*/}, null);
}</pre>
<p>The selecting a file application control service allows you to handle media files (image, audio, or video) in your own application.</p>
<h5 id="appid_file" name="appid_file">Application ID</h5>
<p>This application control can be accessed using aliased application ID of "<span style="font-family: Courier New,Courier,monospace">tizen.filemanager</span>".</p>
+ <p><font color="red">Tizen Alias ID is deprecated since Tizen 2.3.1.</font></p>
<h5 id="operation_file" name="operation_file">PICK Operation</h5>
<p>This application control supports the <span style="font-family: Courier New,Courier,monospace">http://tizen.org/appcontrol/operation/pick</span> operation only.</p>
<p>This operation displays a list of specific type of media files found in the <span style="font-family: Courier New,Courier,monospace">Media</span> folder on the device or memory card, and returns the selected files back to your own application. The device user can browse all the subfolders and select items from one of the subfolders. The operation only displays files that are of the specified type. You can also display all types of media files by defining <span style="font-family: Courier New,Courier,monospace">all</span> as the type in the operation input data.</p>
}
}
-tizen.application.launchAppControl(appControl, "tizen.filemanager",
+tizen.application.launchAppControl(appControl, "tizen.filemanager",
function() {console.log("launch application control succeed");},
function(e) {/* Error handling */}, appControlReplyCallback);
-</pre>
+</pre>
<h2 id="launch" name="launch">Launching an Application with Application Controls</h2>
</pre>
<h3 name="platform" id="platform">Launching Platform Applications</h3>
-<p>The Tizen platform provides <a href="#platform_appcontrol">predefined application controls</a>, such as phone, file manager, image viewer, and Internet. You can run Tizen base applications explicitly with the aliased application IDs.</p>
+<p>The Tizen platform provides <a href="#platform_appcontrol">predefined application controls</a>, such as phone, file manager, image viewer, and Internet. You can run Tizen base applications explicitly with the aliased application IDs.</p>
+<p><font color="red">Tizen Alias ID is deprecated since Tizen 2.3.1.</font></p>
<p>The following code example demonstrates an <span style="font-family: Courier New,Courier,monospace">ApplicationControl</span> interface instance for explicitly launching the image viewer for cropping an image:</p>
<pre class="prettyprint">
/* Assuming that the filesystem virtual root "images" has been resolved and saved in variable images */
var appControl = new tizen.ApplicationControl("http://tizen.org/appcontrol/operation/image/crop",
images.resolve("image12.jpg").toURI(),
"image/*", null , null);
-tizen.application.launchAppControl(appControl, "tizen.imageviewer", successCb, errCb, null);</pre>
-
+tizen.application.launchAppControl(appControl, "tizen.imageviewer", successCb, errCb, null); </pre>
+
<p>The aliased application ID (<span style="font-family: Courier New,Courier,monospace">tizen.imageviewer</span>) is used, and a crop operation on the <span style="font-family: Courier New,Courier,monospace">image12.jpg</span> file is launched.</p>
<table class="note">
<th class="note">Note</th>
</tr>
<tr>
- <td class="note">If you are unsure about whether a user's device has a specific application, use one of the standard Tizen platform applications, such as the phone, image viewer, or file manager, because some version of these applications is available on all Tizen devices. The platform applications use predefined platform application controls and aliased application IDs, which also simplifies the task of launching them.</td>
+ <td class="note">If you are unsure about whether a user's device has a specific application, use one of the standard Tizen platform applications, such as the phone, image viewer, or file manager, because some version of these applications is available on all Tizen devices. The platform applications use predefined platform application controls and aliased application IDs, which also simplifies the task of launching them.
+ <p><font color="red">Tizen Alias ID is deprecated since Tizen 2.3.1.</font></p>
+ </td>
</tr>
</tbody>
</table>
projects / sdk / online-doc.git / commitdiff