Proposal: audible notifications (play a sound with a notification)

[hanguokai]

Overview

When send a notification, play a sound at the same time by specifying an audio file which length is usually about a second. Typical application scenarios like alarms, reminders, notifications, and battery level changes, etc.

This is a strong functional requirement from developers. You can search for "play sound" or "audio notification" in extension developers forum, StackoverFlow, browser's bug trackers and this project, there are many related discussions. So, I don't need to prove the usefulness of this feature.

API

browser.notifications.create(
  id,
  {
    type: "basic",
    iconUrl: "icon.png",
    audio: "notification-sound.mp3", // a new field in NotificationOptions
    title,
    message
  }
)

Web Notification API vs Extension Notification API

Although the functions of these two APIs are similar, the application scenarios of web and extension are obviously different (extensions are more like native apps), which leads to the fact that Web API will be more conservative, while extension API can be more aggressive. So, I think the extension API should support this feature.

Workaround

Note: This api is mainly used from background.

In MV2, event page or background page can play sound directly and easily, i.e. new Audio('sound.mp3').play().

In MV3, service worker can't play sound directly, Chrome supplies the offscreen api as a temporary workaround for general purpose DOM functions.

Because playing a sound with a notification is a very common and highly demanded feature, I think extension notification API should have built-in support for it.

[Rob--W]

As noted in today's meeting (#357 , will be published at https://github.com/w3c/webextensions/blob/main/_minutes/2023-03-02-wecg.md), the browser vendors are neutral towards this feature, provided that the flag is advisory and not mandatory. Advisory, in case the platform does not support audio notifications or if the user has chosen to disable/mute audio notifications.

[hanguokai]

The issue claims that the feature is common and highly demanded. Does anyone have data that backs this claim? - A question in the meeting note.

Let me give some links that can reflect the needs of developers and users.

Stackoverflow:

• How to play a notification sound on websites?. Question up vote: 135, Answer up vote: 167.
• Playing sound notifications using Javascript?. Question up vote: 88
• How to implement a notification popup with sound in chrome extension Question up vote: 20, Answer up vote: 34.
• how to play a custom sound when web push notification received

Developers Forum:

• Playing audio with service workers

Issue Trackers:

• Issue 1131236: Playing audio in service worker-based browser extensions. Starred by 138 users with 85 comments.

Extensions in Web Stores:

• Email Checker Extensions
• Battery Level Reminder Extensions
• Alarm Extensions

Real user reviews from Web Stores:

• Would be extra brilliant if it comes with audible notifications.
• I don't know yet if this extension gives an audible notification, but if it does, I'll be even more in love with it.

If you expand the audio notification feature from the web platform to mobile and desktop platforms, you will find more developer and user needs and instances.