* distributed under the License is distributed on an AS IS BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
- * limitations under the License.
+ * limitations under the License.
*/
#ifndef __TIZEN_MESSAGING_TYPES_H__
/**
* @brief The messaging service handle.
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
*/
typedef struct messages_service_s *messages_service_h;
/**
* @brief The message handle.
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
*/
typedef struct messages_message_s *messages_message_h;
/**
- * @brief The message box type.
+ * @brief Enumeration for the message box type.
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
*/
typedef enum {
- MESSAGES_MBOX_ALL = 0, /**< All message box type */
- MESSAGES_MBOX_INBOX = 1, /**< Inbox type */
- MESSAGES_MBOX_OUTBOX = 2, /**< Outbox type*/
- MESSAGES_MBOX_SENTBOX = 3, /**< Sentbox type */
- MESSAGES_MBOX_DRAFT = 4, /**< Draft type */
+ MESSAGES_MBOX_ALL = 0, /**< All message box type */
+ MESSAGES_MBOX_INBOX = 1, /**< Inbox type */
+ MESSAGES_MBOX_OUTBOX = 2, /**< Outbox type*/
+ MESSAGES_MBOX_SENTBOX = 3, /**< Sentbox type */
+ MESSAGES_MBOX_DRAFT = 4, /**< Draft type */
} messages_message_box_e;
/**
- * @brief The message type.
+ * @brief Enumeration for the message type.
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
*/
typedef enum {
- MESSAGES_TYPE_UNKNOWN = 0, /**< Unknown type */
- MESSAGES_TYPE_SMS = 1, /**< SMS type */
- MESSAGES_TYPE_MMS = 2, /**< MMS type */
+ MESSAGES_TYPE_UNKNOWN = 0, /**< Unknown type */
+ MESSAGES_TYPE_SMS = 1, /**< SMS type */
+ MESSAGES_TYPE_MMS = 2, /**< MMS type */
+ MESSAGES_TYPE_SMS_CB = MESSAGES_TYPE_SMS | 1 << 4, /**< CB(Cell Broadcast) Type */
+ MESSAGES_TYPE_SMS_PUSH = MESSAGES_TYPE_SMS | 10 << 4, /**< WAP Push Type */
+ MESSAGES_TYPE_SMS_ETWS_PRIMARY = MESSAGES_TYPE_SMS | 21 << 4, /**< ETWS(Earthquake and Tsunami Warning System) Primary Type */
+ MESSAGES_TYPE_SMS_ETWS_SECONDARY = MESSAGES_TYPE_SMS | 22 << 4, /**< ETWS(Earthquake and Tsunami Warning System) Secondary Type */
} messages_message_type_e;
/**
- * @brief The attachment type for MMS messaging.
+ * @brief Enumeration for the attachment type for MMS messaging.
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
*/
typedef enum {
- MESSAGES_MEDIA_UNKNOWN = 0, /**< Unknown */
- MESSAGES_MEDIA_IMAGE = 1, /**< The image */
- MESSAGES_MEDIA_AUDIO = 2, /**< The audio */
- MESSAGES_MEDIA_VIDEO = 3, /**< The video */
+ MESSAGES_MEDIA_UNKNOWN = 0, /**< Unknown */
+ MESSAGES_MEDIA_IMAGE = 1, /**< The image */
+ MESSAGES_MEDIA_AUDIO = 2, /**< The audio */
+ MESSAGES_MEDIA_VIDEO = 3, /**< The video */
} messages_media_type_e;
/**
- * @brief The recipient type of a message.
+ * @brief Enumeration for the recipient type of a message.
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
*/
typedef enum {
MESSAGES_RECIPIENT_UNKNOWN = 0, /**< Unknown */
- MESSAGES_RECIPIENT_TO = 1, /**< The 'To' recipient */
- MESSAGES_RECIPIENT_CC = 2, /**< The 'Cc' (carbon copy) recipient */
- MESSAGES_RECIPIENT_BCC = 3, /**< The 'Bcc' (blind carbon copy) recipient */
+ MESSAGES_RECIPIENT_TO = 1, /**< The 'To' recipient */
+ MESSAGES_RECIPIENT_CC = 2, /**< The 'Cc' (carbon copy) recipient */
+ MESSAGES_RECIPIENT_BCC = 3, /**< The 'Bcc' (blind carbon copy) recipient */
} messages_recipient_type_e;
/**
- * @brief The result of sending a message.
+ * @brief Enumeration for the result of sending a message.
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
*/
typedef enum {
- MESSAGES_SENDING_FAILED = -1, /**< Message sending is failed */
- MESSAGES_SENDING_SUCCEEDED = 0, /**< Message sending is succeeded */
+ MESSAGES_SENDING_FAILED = -1, /**< Message sending failed */
+ MESSAGES_SENDING_SUCCEEDED = 0, /**< Message sending succeeded */
} messages_sending_result_e;
+/**
+ * @brief Enumeration for the SIM index of a message.
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ */
+typedef enum {
+ MESSAGES_SIM_INDEX_UNKNOWN = 0, /**< Unknown SIM Index*/
+ MESSAGES_SIM_INDEX_1 = 1, /**< SIM Index 1 */
+ MESSAGES_SIM_INDEX_2 = 2, /**< SIM Index 2 */
+} messages_sim_index_e;
/**
- * @brief Called when the process of sending a message to all recipients finishes.
+ * @brief Called when the process of sending a message to all recipients finishes.
*
- * @param[in] result The result of message sending.
- * @param[in] user_data The user data passed from the callback registration function
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
*
- * @pre messages_send_message() will invoke this callback if you register this callback using messages_set_message_sent_cb().
+ * @param[in] result The result of message sending
+ * @param[in] user_data The user data passed from the callback registration function
+ *
+ * @pre messages_send_message() will invoke this callback function.
*
- * @see messages_set_message_sent_cb()
- * @see messages_unset_message_sent_cb()
* @see messages_send_message()
*/
typedef void (* messages_sent_cb)(messages_sending_result_e result, void *user_data);
/**
* @brief Called when an incoming message is received.
*
- * @param[in] incoming_msg An incoming message
- * @param[in] user_data The user data passed from the callback registration function
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ *
+ * @param[in] incoming_msg The incoming message
+ * @param[in] user_data The user data passed from the callback registration function
*
* @pre You register this callback using messages_set_message_incoming_cb() for getting an incoming message.
*
/**
* @brief Called when a message is retrieved from a search request.
*
- * @remark You should not call messages_destroy_message() with @a msg.
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ *
+ * @remarks You should not call messages_destroy_message() with @a msg.
*
- * @param[in] msg The message handle (It can be NULL if nothing is found)
- * @param[in] user_data The user data passed from the foreach function
- * @param[in] index The index of a message from the messages that have been retrieved as a search result
- * @param[in] result_count The count of the messages that have been retrieved as a result applying @a limit and @a offset.\n
- * If the search has a @a limit, then this value is always equal or less than the limit.
- * @param[in] total_count The count of the messages that have been retrieved as a result without applying @a limit and @a offset. \n
- * The value can be used to calculate the total number of page views for the searched meessages.\n
- * For example, if the count of message search is 50 and the limit is 20, then using this value, you can notice the total page is 3.
+ * @param[in] msg The message handle \n
+ * It can be @c NULL if nothing is found.
+ * @param[in] user_data The user data passed from the foreach function
+ * @param[in] index The index of a message from the messages that have been retrieved as a search result
+ * @param[in] result_count The count of the messages that have been retrieved as a result applying @a limit and @a offset \n
+ * If the search has a @a limit, then this value is always equal or less than the limit.
+ * @param[in] total_count The count of the messages that have been retrieved as a result without applying @a limit and @a offset \n
+ * The value can be used to calculate the total number of page views for the searched messages. \n
+ * For example, if the count of message search is @c 50 and the limit is @c 20, then using this value, you can notice the total page is @c 3.
*
- * @return @c true to continue with the next iteration of the loop or return @c false to break out of the loop.
+ * @return @c true to continue with the next iteration of the loop,
+ * otherwise return @c false to break out of the loop
*
* @pre messages_foreach_message() will invoke this callback function.
*
typedef bool (* messages_search_cb)(messages_message_h msg, int index, int result_count, int total_count, void *user_data);
+ /**
+ * @addtogroup CAPI_MESSAGING_MESSAGES_PUSH_MODULE
+ * @{
+ */
+
+/**
+ * @brief Called when an incoming push message is received.
+ *
+ * @since_tizen @if MOBILE 2.3 @elseif WEARABLE 2.3.1 @endif
+ *
+ * @param[in] header The header of the push message
+ * @param[in] body The body of the push message \n
+ * It is not a null-terminated string.
+ * @param[in] body_length The length of @a body
+ * @param[in] user_data The user data to be passed to the callback function
+ *
+ * @pre You register this callback using messages_push_set_incoming_cb() for getting an incoming message.
+ *
+ * @see messages_push_set_incoming_cb()
+ * @see messages_push_unset_incoming_cb()
+ */
+typedef void (* messages_push_incoming_cb)(const char *header, const char *body, int body_length, void *user_data);
+
+/**
+ * @}
+ */
+
+
/**
* @}
*/