notification_message_set_sound_url()

#include <bps/notification.h>
 

BPS_API int notification_message_set_sound_url(notification_message_t *message,
                                               const char *sound_url)

Since:

BlackBerry 10.0.0

Arguments:

message

A pointer to the notification_message_t structure whose sound_url you want to set.

sound_url

The URL of the sound to play with the notification.

Library:

libbps (For the qcc command, use the -l bps option to link against this library)

Description:

The notification_message_set_sound_url() function allows applications to play different sounds within notifications of the same type. The sound data member is valid for the notification_alert() and notification_notify() functions.

This property is optional. We recommend that you specify the sound name in the settings for the application/notification type.

If you don't call this function, a default sound specified in settings is played.

Returns:

BPS_SUCCESS upon success, BPS_FAILURE with errno set otherwise.