Difference between revisions of "PlaySound Command"
From GeoGebra Manual
(https://test.geogebra.org/~mike/utils/base64Encode.html ) |
|||
(27 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
− | + | <noinclude>{{Manual Page|version=5.0}}</noinclude>{{command|scripting}} | |
− | <noinclude>{{Manual Page|version= | + | ;PlaySound( <URL> ) |
− | {{command|scripting}} | + | : Plays an MP3 (.mp3) file |
− | ;PlaySound[ <Note>, <Duration>, <Instrument> | + | :{{Examples|1=<div> |
− | :Plays a MIDI note. | + | :*<code><nowiki>PlaySound("http://static.geogebra.org/welcome_to_geogebra.mp3")</nowiki></code> |
+ | :*<code>PlaySound("#J2sQQfwQ")</code> plays an [http://www.geogebra.org/m/J2sQQfwQ .mp3 that has been uploaded to GeoGebra] | ||
+ | :*<code><nowiki>PlaySound("https://drive.google.com/uc?id=0B7xCmZaU3oU2eXFNUzd6ZlZJS0U&authuser=0&export=download")</nowiki></code> plays an .mp3 from Google Drive | ||
+ | :*<code><nowiki>PlaySound("https://www.dropbox.com/s/27skpv82odjp7ej/material-1264825.mp3?dl=1")</nowiki></code> plays an .mp3 from DropBox </div>}} | ||
+ | |||
+ | :{{note| 1= To work on iOS (and also if you want immediate playback) then you can encode the .mp3 as an inline base64-encoded data: URL, see https://www.geogebra.org/m/wztkqxuv for an example. It must start with the ''exact'' string <code>data:audio/mp3;base64,</code> to work in GeoGebra Classic 5. You can use this utility to convert .MP3s into the syntax needed in GeoGebra https://test.geogebra.org/~mike/utils/base64Encode.html }} | ||
+ | |||
+ | |||
+ | ;PlaySound( <Boolean Play> ) | ||
+ | :Pause or resume play (not MP3 files) | ||
+ | :<code>PlaySound(true)</code> = play, <code>PlaySound(false)</code> = pause. | ||
+ | |||
+ | ;PlaySound( <Function>, <Min Value>, <Max Value> ) | ||
+ | :Plays a sound generated by Function, a time-valued function with range [-1,1]. The time units are seconds and the sound is played from time Min Value to Max Value. Sound is generated by 8-bit samples taken at a rate of 8000 samples per second. | ||
+ | |||
+ | :{{Example| 1=<code>PlaySound(sin(440 2Pi x), 0, 1)</code> | ||
+ | :This plays a pure sine wave tone at 440 Hz (musical note A) for one second.}} | ||
+ | |||
+ | ;PlaySound( <Function>, <Min Value>, <Max Value>, <Sample Rate>, <Sample Depth> ) | ||
+ | :Plays a sound generated by Function, a time-valued function with range [-1,1]. The time units are seconds and the sound is played from time Min Value to Max Value. The sampling method is specified by "Sample Depth" and "Sample Rate". | ||
+ | :"Sample Rate" is the number of sample function values taken each second. Allowable values are 8000, 11025, 16000, 22050, or 44100 | ||
+ | :"Sample Depth" is the data size of a sample in bits. Allowable values are 8 and 16. | ||
+ | |||
+ | ;PlaySound( <Note>, <Duration>, <Instrument> ) (GeoGebra Classic 5 only) | ||
+ | :Plays a [[w:MIDI|MIDI]] note. | ||
:''Note'' is an integer from 0 to 127 that represents a musical note given by the table below. When note = 60 a Middle C is played. | :''Note'' is an integer from 0 to 127 that represents a musical note given by the table below. When note = 60 a Middle C is played. | ||
:''Duration'' is the time to play the note in seconds. | :''Duration'' is the time to play the note in seconds. | ||
− | :''Instrument'' is an integer that represents the synthesized instrument used to play the note. See [http://www. | + | :''Instrument'' is an integer that represents the synthesized instrument used to play the note. See [https://web.archive.org/web/20130919034922/http://www.classicalmidiconnection.com/General_Midi.html technical specifications] for possible instruments. |
:Most instruments are supported, but there are differences between computer platforms. | :Most instruments are supported, but there are differences between computer platforms. | ||
::{| class="pretty" | ::{| class="pretty" | ||
Line 85: | Line 109: | ||
|50 | |50 | ||
|51 | |51 | ||
− | | | + | |52 |
|53 | |53 | ||
|54 | |54 | ||
Line 179: | Line 203: | ||
|+ | |+ | ||
|} | |} | ||
− | + | <br> | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− |
Latest revision as of 11:51, 8 October 2019
- PlaySound( <URL> )
- Plays an MP3 (.mp3) file
- Examples:
PlaySound("http://static.geogebra.org/welcome_to_geogebra.mp3")
PlaySound("#J2sQQfwQ")
plays an .mp3 that has been uploaded to GeoGebraPlaySound("https://drive.google.com/uc?id=0B7xCmZaU3oU2eXFNUzd6ZlZJS0U&authuser=0&export=download")
plays an .mp3 from Google DrivePlaySound("https://www.dropbox.com/s/27skpv82odjp7ej/material-1264825.mp3?dl=1")
plays an .mp3 from DropBox
- Note: To work on iOS (and also if you want immediate playback) then you can encode the .mp3 as an inline base64-encoded data: URL, see https://www.geogebra.org/m/wztkqxuv for an example. It must start with the exact string
data:audio/mp3;base64,
to work in GeoGebra Classic 5. You can use this utility to convert .MP3s into the syntax needed in GeoGebra https://test.geogebra.org/~mike/utils/base64Encode.html
- PlaySound( <Boolean Play> )
- Pause or resume play (not MP3 files)
PlaySound(true)
= play,PlaySound(false)
= pause.
- PlaySound( <Function>, <Min Value>, <Max Value> )
- Plays a sound generated by Function, a time-valued function with range [-1,1]. The time units are seconds and the sound is played from time Min Value to Max Value. Sound is generated by 8-bit samples taken at a rate of 8000 samples per second.
- Example:
PlaySound(sin(440 2Pi x), 0, 1)
- This plays a pure sine wave tone at 440 Hz (musical note A) for one second.
- PlaySound( <Function>, <Min Value>, <Max Value>, <Sample Rate>, <Sample Depth> )
- Plays a sound generated by Function, a time-valued function with range [-1,1]. The time units are seconds and the sound is played from time Min Value to Max Value. The sampling method is specified by "Sample Depth" and "Sample Rate".
- "Sample Rate" is the number of sample function values taken each second. Allowable values are 8000, 11025, 16000, 22050, or 44100
- "Sample Depth" is the data size of a sample in bits. Allowable values are 8 and 16.
- PlaySound( <Note>, <Duration>, <Instrument> ) (GeoGebra Classic 5 only)
- Plays a MIDI note.
- Note is an integer from 0 to 127 that represents a musical note given by the table below. When note = 60 a Middle C is played.
- Duration is the time to play the note in seconds.
- Instrument is an integer that represents the synthesized instrument used to play the note. See technical specifications for possible instruments.
- Most instruments are supported, but there are differences between computer platforms.
MIDI Notes Octave C C# D D# E F F# G G# A A# B 0 0 1 2 3 4 5 6 7 8 9 10 11 1 12 13 14 15 16 17 18 19 20 21 22 23 2 24 25 26 27 28 29 30 31 32 33 34 35 3 36 37 38 39 40 41 42 43 44 45 46 47 4 48 49 50 51 52 53 54 55 56 57 58 59 5 60 61 62 63 64 65 66 67 68 69 70 71 6 72 73 74 75 76 77 78 79 80 81 82 83 7 84 85 86 87 88 89 90 91 92 93 94 95 8 96 97 98 99 100 101 102 103 104 105 106 107 9 108 109 110 111 112 113 114 115 116 117 118 119 10 120 121 122 123 124 125 126 127