Merge branch 'master' of https://github.com/20tab/UnrealEnginePython

Roberto De Ioris · Roberto De Ioris · commit 8e1f0849de0a · 2016-08-11T19:13:12.000+02:00
diff --git a/README.md b/README.md
@@ -548,6 +548,32 @@ Currently there is no support for defining custom events from python. The best t
 
 ![Alt text](screenshots/unreal_screenshot3.png?raw=true "Screenshot 3")
 
+Audio
+-----
+
+The uobject.play_sound_at_location(sound, x, y, z[, volume_multiplier, pitch_multiplier, start_time]) api method is exposed:
+
+```py
+# get a reference to asound
+sound = ue.find_object('my_sound')
+# play the sound at position 0,0,0
+self.uobject.play_sound_at_location(sound, 0, 0, 0)
+```
+
+If you prefer to work with AudioComponent:
+
+```py
+class Sounder:
+    def begin_play(self):
+        # find the AudioComponent of this actor
+        self.audio = self.uobject.get_component_by_type('AudioComponent')
+        self.audio.call('Stop')
+    def tick(self, delta_time):
+        # start the sound when pressing 'A'
+        if self.uobject.is_input_key_down('A'):
+            self.audio.call('Play')
+```
+
 Packaging
 ---------
 
