Difference between revisions of "PlaySound Command"
From GeoGebra Manual
(:Pause or resume play (not MP3 files)) |
(https://test.geogebra.org/~mike/utils/base64Encode.html ) |
||
(7 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
<noinclude>{{Manual Page|version=5.0}}</noinclude>{{command|scripting}} | <noinclude>{{Manual Page|version=5.0}}</noinclude>{{command|scripting}} | ||
− | ;PlaySound | + | ;PlaySound( <URL> ) |
: Plays an MP3 (.mp3) file | : Plays an MP3 (.mp3) file | ||
:{{Examples|1=<div> | :{{Examples|1=<div> | ||
− | :*<code><nowiki>PlaySound | + | :*<code><nowiki>PlaySound("http://static.geogebra.org/welcome_to_geogebra.mp3")</nowiki></code> |
− | :*<code>PlaySound | + | :*<code>PlaySound("#J2sQQfwQ")</code> plays an [http://www.geogebra.org/m/J2sQQfwQ .mp3 that has been uploaded to GeoGebra] |
− | :*<code><nowiki>PlaySound | + | :*<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 | + | :*<code><nowiki>PlaySound("https://www.dropbox.com/s/27skpv82odjp7ej/material-1264825.mp3?dl=1")</nowiki></code> plays an .mp3 from DropBox </div>}} |
− | ;PlaySound | + | :{{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) | :Pause or resume play (not MP3 files) | ||
− | :<code>PlaySound | + | :<code>PlaySound(true)</code> = play, <code>PlaySound(false)</code> = pause. |
− | ;PlaySound | + | ;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. | :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 | + | :{{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.}} | :This plays a pure sine wave tone at 440 Hz (musical note A) for one second.}} | ||
− | ;PlaySound | + | ;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". | :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 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. | :"Sample Depth" is the data size of a sample in bits. Allowable values are 8 and 16. | ||
− | ;PlaySound | + | ;PlaySound( <Note>, <Duration>, <Instrument> ) (GeoGebra Classic 5 only) |
:Plays a [[w:MIDI|MIDI]] note. | :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. |
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