stop melody block (#1633)

* docs

* updated strings

libs/core/music.ts

@@ -127,7 +127,7 @@ enum BeatFraction {
 }
 
 enum MelodyOptions {
-    //% block="once""
+    //% block="once"
     Once = 1,
     //% block="forever"
     Forever = 2,
@@ -137,6 +137,15 @@ enum MelodyOptions {
     ForeverInBackground = 8
 }
 
+enum MelodyStopOptions {
+    //% block="all"
+    All = MelodyOptions.Once | MelodyOptions.OnceInBackground,
+    //% block="foreground"
+    Foreground = MelodyOptions.Once,
+    //% block="background"
+    Background = MelodyOptions.OnceInBackground
+}
+
 enum MusicEvent {
     //% block="melody note played"
     MelodyNotePlayed = 1,
@@ -349,6 +358,20 @@ namespace music {
         }
     }
 
+    /**
+     * Stops the melodies
+     * @param options which melody to stop
+     */
+    //% help=music/stop-melody weight=59 blockGap=16
+    //% blockId=device_stop_melody block="stop melody $options"
+    //% parts="headphone"
+    export function stopMelody(options: MelodyStopOptions) {
+        if (options & MelodyStopOptions.Foreground)
+            beginMelody([], MelodyOptions.Once);
+        if (options & MelodyStopOptions.Background)
+            beginMelody([], MelodyOptions.OnceInBackground);
+    }
+
     /**
      * Sets a custom playTone function for playing melodies
      */