lib/app/audio.nit

   1 # This file is part of NIT ( http://www.nitlanguage.org ).
   2 #
   3 # Copyright 2014 Romain Chanoir <romain.chanoir@viacesi.fr>
   4 #
   5 # Licensed under the Apache License, Version 2.0 (the "License");
   6 # you may not use this file except in compliance with the License.
   7 # You may obtain a copy of the License at
   8 #
   9 #     http://www.apache.org/licenses/LICENSE-2.0
  10 #
  11 # Unless required by applicable law or agreed to in writing, software
  12 # distributed under the License is distributed on an "AS IS" BASIS,
  13 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14 # See the License for the specific language governing permissions and
  15 # limitations under the License.
  16
  17 # Services to load and play `Sound` and `Music` from the assets folder
  18 #
  19 # Get a handle to a sound using `new Sound` or `new Music` at any time.
  20 # Call `load` at or after `App::on_create` or leave it to be loaded
  21 # on demand by the first call to `play`.
  22 module audio
  23
  24 import app_base
  25 import core::error
  26
  27 # Platform variations
  28 import linux::audio is conditional(linux)
  29 import android::audio is conditional(android)
  30
  31 # Abstraction of a playable Audio
  32 abstract class PlayableAudio
  33
  34         init do sounds.add self
  35
  36         # Path to the audio file in the assets folder
  37         var path: String
  38
  39         # Last error on this sound, if any
  40         fun error: nullable Error do return null
  41
  42         # Load this playable audio
  43         fun load do end
  44
  45         # Play the sound
  46         fun play do end
  47
  48         # Pause the sound
  49         fun pause do end
  50
  51         # Resume the sound
  52         fun resume do end
  53 end
  54
  55 # Short sound
  56 class Sound
  57         super PlayableAudio
  58 end
  59
  60 # Long sound that can bee looped
  61 class Music
  62         super PlayableAudio
  63 end
  64
  65 redef class Sys
  66
  67         # All instantiated sounds
  68         var sounds = new Array[PlayableAudio]
  69 end