com.webos.service.intent

An intent is an abstract description of an operation to be performed. Intent manager is a native service to handle the intent.

There are two types of intent:

• Implicit Intent : Does not specify a component
• Explicit Intent : Specifies a component

Intent manager has roles to handle intents and manage handlers.

• Intent: An abstract description of an operation to be performed.
• Handler: System components which can handle specific type of intents.
• Requester: System components which want to start an intent.

When the requester calls the start API with an intent, intent manager finds the suitable handler in the handler pool. Normally, handler is an app, so intent manager calls the launch API in the SAM to launch the (handler) app. The intent object is passed to application through launch params object

Sometimes, requester wants to get result from the handler. In such case, requester should subscribe to the start API to get the subscription message from the handler. Intent manager sends subscription message when the handler calls the sendResult API.

Requester can subscribe to the result by using the subscribeResult API also.

Steps to support intent - application

1. Modify appinfo.json first to support intent. Here is a simple example for enact browser. Lines highlighted in the below json code are newly added.

   $ vi /usr/palm/applications/com.webos.app.enactbrowser/appinfo.json
   {
            ....
            "mimeTypes": [                                             
                   {                                   
                           "mime": "text/html",
                           "extension": "html",                       
                           "stream": true              
                   },                          
                   {                                                  
                           "scheme": "http"            
                   },                          
                   {                                                  
                           "scheme": "https"           
                   }                           
           ],                                                         
           "intentFilters": [               
               {                               
                   "actions": ["action_url", "action_uri"],
                   "uris": ["http://youtube.com", "http://", "https://"]
               }                               
           ],
           ....
   }
   

2. To apply the changes, restart the SAM module and intent manager.

   $ restart sam
   $ restart com.webos.service.intent

3. Verify the changes:
   • On the SAM module:

     $ luna-send -f -n 1 luna://com.webos.service.applicationmanager/getAppInfo '{ "id": "com.webos.app.enactbrowser"}'

     Response:

     {
         "appId": "com.webos.app.enactbrowser",
         "returnValue": true,
         "appInfo": {
             ....
             "intentFilters": [
                 {
                     "uris": [
                         "http://youtube.com",
                         "http://",
                         "https://"
                     ],
                     "actions": [
                         "action_url",
                         "action_uri"
                     ]
                 }
             ],
             ....
         }
     }

   • On intent manager:

     # luna-send -f -n 1 luna://com.webos.service.intent/query '{ "intent": { "action": "action_url", "uri":"http://google.com"}}'

     Response:

     {
         "returnValue": true,
         "handlers": [
             {
                 "name": "com.webos.app.enactbrowser",
                 "intentFilters": [
                     {
                         "uris": [
                             "http://youtube.com",
                             "http://",
                             "https://"
                         ],
                         "actions": [
                             "action_url",
                             "action_uri"
                         ]
                     }
                 ]
             }
         ]
     }

4. Start 'intent' and verify the handler.

   $ luna-send -f -n 1 luna://com.webos.service.intent/start '{ "intent": { "action": "action_url", "uri":"http://google.com"}}'

   Response:

   {
       "intentId": 10,
       "returnValue": true
   }

List of intents

For a list of supported intents, see the following webOS Intents table.

Intents must be specified in the following form:

query

sendResult

start

subscribeResult

handler

intent

intentFilter