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 # App audio abstraction
  18 # Default behaviour is loading the audio from the `assets` folder of the project with its name and extension
  19 # Platforms implementations can modify this comportement
  20 #
  21 # Once the application has started (after `App.setup`)
  22 # use `App.load_sound` to get a sound
  23 # then `Sound.play` to play it
  24 module audio
  25
  26 import app_base
  27 import standard::error
  28
  29 # Platform variations
  30 # TODO: move on the platform once qualified names are understand in the condition
  31 import linux::audio is conditional(linux)
  32 import android::audio is conditional(android)
  33
  34 # Abstraction of a playable Audio
  35 abstract class PlayableAudio
  36
  37         # Name of this playable audio
  38         var name: String
  39
  40         # Error which is not null if an error happened
  41         var error: nullable Error = null is writable
  42
  43         # Is this already loaded ?
  44         protected var is_loaded = false is writable
  45
  46         # Load this playable audio
  47         fun load is abstract
  48
  49         # Plays the sound
  50         fun play is abstract
  51
  52         # Pauses the sound
  53         fun pause is abstract
  54
  55         # Resumes the sound
  56         fun resume is abstract
  57 end
  58
  59 # Abstraction of a short sound
  60 class Sound
  61         super PlayableAudio
  62 end
  63
  64 # Abstraction of a long song, that can bee looped
  65 class Music
  66         super PlayableAudio
  67 end
  68
  69 redef class App
  70
  71         # Load a sound
  72         fun load_sound(name: String): Sound is abstract
  73
  74         # Load a music
  75         fun load_music(name: String): Music is abstract
  76 end