Figured out Cocos2D Python audio

Author: liamrahav

README.md

@@ -36,10 +36,15 @@ On Mac, installation is made easy thanks to Homebrew. If you don't have it insta
 On other operating systems such as Windows or Linux distributions, head to http://www.scipy.org/install.html for more information on how to install for your particular operating system.
 
 ###AVbin
-AVbin is a package that provides audio and video support for Cocos2D Python.
+AVbin is a package that provides some audio and the video support for Cocos2D Python.
 
 Head to https://avbin.github.io/AVbin/Download.html to download the correct installer for your operating system.
 
+###SDL
+SDL is the framework that PyGame (another Python game library) relies on for audio support. Cocos uses it for it's audio as well.
+
+Head over to https://www.libsdl.org/download-1.2.php to download the base SDL library and then to https://www.libsdl.org/projects/SDL_mixer/release-1.2.html to download the Mixer library from SDL (which was what we will be using for audio support in our games)
+
 ----------------------------------------------------------------------------
 Now that you're all set up you should be ready to install Cocos2D
 
@@ -64,7 +69,7 @@ The code is grouped in folders by their difficulty level. Here is how it's mostl
             | examples
 
 
-From here you should be read to start reading through the samples and trying out the concepts yourself. I group the the code by difficulty level, so I recommend starting in the `basics` folder and working your way up.
+From here you should be ready to start reading through the samples and trying out the concepts yourself. I group the the code by difficulty level, so I recommend starting in the `basics` folder and working your way up.
 
 It's important to note that `basics` does not mean Python basics! You should at least have a basic grasp on writing object oriented code before trying to jump into Cocos2D Python!
 

basics/actions.py

@@ -1,5 +1,5 @@
 
-# I chose these import statements just to make my close look cleaner
+# I chose these import statements just to make my code look cleaner
 # For this to work you would just need to import cocos and then add the subdirectory after
 # Ex: self.sprite = Sprite('directory') would be self.sprite = cocos.sprite.Sprite('directory')
 import cocos

basics/assets/sound/LatinIndustries.wav

@@ -0,0 +1,38 @@
+# Again very similar inputs to what we had before
+from cocos import scene
+from cocos.layer import Layer
+from cocos.director import director
+
+# Except for these imports
+# It might seem odd that it's importing from pygame, but really it's importing SDL libraries
+from cocos.audio.pygame.mixer import Sound
+from cocos.audio.pygame import mixer
+
+
+# Our first multi-class program! Nice
+# First we need to create a wrapper around the SDL Sound class
+# We do this by creating our own object that simply initializes the parent with a file name that we pass in
+# You'll see this in action in a second
+class Audio(Sound):
+    def __init__(self, audio_file):
+        # As stated above, we initialize the super class with the audio file we passed in
+        super(Audio, self).__init__(audio_file)
+
+
+# Here we create your standard layer
+class AudioLayer(Layer):
+    def __init__(self):
+        super(AudioLayer, self).__init__()
+        # Now, in the layer we create an Audio object from the class we described above
+        song = Audio("assets/sound/LatinIndustries.wav")
+        # And lastly we make the song play when the layer is initialized
+        song.play(-1)  # Setting the parameter to -1 makes the song play indefinitely
+
+
+# Now we have more things to initialize than just the director
+director.init()
+# The audio mixer also needs us to tell it to get ready!
+mixer.init()
+
+# And lastly we run the scene like usual
+director.run(scene.Scene(AudioLayer()))

basics/assets/sound/sound.wav

@@ -8,4 +8,5 @@ Here is the order which the tutorial follows:
 3.  Basic Actions (actions.py)
 4.  Keyboard Input (keyboard.py)
 5.  Mouse Input (mouse.py)
-6.  Applying User Input (input.py)
+6.  Applying User Input (input.py)
+7.  Audio Playback (audio.py)

basics/audio.py

@@ -51,7 +51,7 @@ def on_mouse_press(self, x, y, buttons, modifiers):
 
     # Once again we overload a default event handler
     def on_key_press(self, key, modifiers):
-        # First I create a move actions because we programmers are lazy and hate having to retype code!
+        # First I create a move action because we programmers are lazy and hate having to retype code!
         move_left = MoveBy((-50, 0), .5)
 
         # Here's where that Pyglet symbol_string() function comes in handy
@@ -65,7 +65,7 @@ def on_key_press(self, key, modifiers):
             # I only wrote code for moving left, but I can use the Reverse() function instead of rewriting code
             # Reverse() simply tells Cocos to do the reverse action of whatever you pass into it.
             self.sprite.do(Reverse(move_left))
-            
+
 
 # And once again the same init code
 director.init()