Confirmed users
398
edits
WebAPI/AppDefinedTeleophony: Difference between revisions
Jump to navigation
Jump to search
no edit summary
No edit summary |
|||
| Line 33: | Line 33: | ||
* Contacts App wakes up Skype for adding a new friend. | * Contacts App wakes up Skype for adding a new friend. | ||
* The user add a new friend of Skype, and Skype will check if the account is valid. | * The user add a new friend of Skype, and Skype will check if the account is valid. | ||
* If it is a valid account, and the peer, the friend, accept the request of adding as a friend. Then, add the address to the contact that the user choose to initiate the action. | * If it is a valid account, and the peer, the friend, accept the request of adding as a friend. Then, | ||
** add the address to the contact that the user choose to initiate the action, or | |||
** postResult() with peer's account/address. | |||
== Import Contacts from Communication Apps == | |||
To import Contacts from a Communication App; Skype for example, it add new contacts with Contacts API. | |||
== Messaging API == | == Messaging API == | ||
| Line 66: | Line 71: | ||
== Call History == | == Call History == | ||
There is no API for call history. We need a new API for that. It must have the capability of telling what the App can handle an address/number in the call history. | There is no API for call history. We need a new API for that. It must have the capability of telling what the App can handle an address/number in the call history. | ||
== Make a Voice Call == | |||
When the user want to make a voice call to John; one of his firends, | |||
* he go to Contacts App to find out John. | |||
* Then, the user press on John's Skype phone account. | |||
* Contacts App ask the user what he want to do. Sending a message, making a voice call, or making a video call. | |||
* The user ask for making a voice call. | |||
* Contacts App ask Skype to make a voice call to John. | |||
== Send a Message == | |||
When the user want to send a message to John; one of his friends, | |||
* he go to Contacts App to find out John. | |||
* Then, the user press on John's Facebook account. | |||
* Contacts App ask the user what he want to do. | |||
* The user ask for sending a message. | |||
* Contacts App ask Facebook App to send a message to John. | |||
== Reply a Message == | |||
When the user reading a message with a Message App, | |||
* the user press on a "Reply" button. | |||
* The Message App send a Web Activity for the name given by Message::handler; for ex. "Twitter", and with the Message ID. | |||
* Then, the communication App is responsible for editing and sending a message. | |||
Message::receiver, for here, are used by the communication App to determine an account for replying the message if the App supports multiple accounts for an installation. The user may change the sender of a message instead of the value from Message::receiver. For example, some MUAs allow users to assign |From| field while composing a message. | |||
== Communication Apps == | == Communication Apps == | ||
The communication apps are invoked through | The communication apps are invoked through [[WebAPI/WebActivities|Web Activities]]. A communication App should provide following functions. | ||
* initiate a voice/video call to a receiver | * initiate a voice/video call to a receiver | ||
* reply an existing message in the database of Messaging API | * reply an existing message in the database of Messaging API | ||
* send a new message to a given receiver | * send a new message to a given receiver | ||
* show a user in contacts | * show a user in contacts | ||
* add a new friend account/address for an existing contact. | |||
The | The communication apps are responsible for handling incoming calls and messages. But, they store contacts, messages, and call history in ContactsAPI, Messaging API, and call history API. | ||
Communication Apps should be registered with their capabilities; messaging, voice call, and video call, so a contacts app can provide correct functions on UI to the user for a given address handled by a communication App. That means we should provide an API to query capabilities of and list apps. | Communication Apps should be registered with their capabilities; messaging, voice call, and video call, so a contacts app can provide correct functions on UI to the user for a given address handled by a communication App. That means we should provide an API to query capabilities of and list apps. | ||