I'm trying to use this, seemingly simple, event:

http://www.creationkit.com/Play_-_Sound

But not being a 'coder' kind of person, I'm hitting a wall and I'm hoping someone can enlighten me.

The Syntax:

int Function Play(ObjectReference akSource) native

Is meant to go into the header before any events fire?

and the example they give goes into an event? :

int instanceID = mySFX.play(self)		  ; play mySFX sound from my selfSound.SetInstanceVolume(instanceID, 0.5)		 ; play at half volume

So far it just throws me a 'variable mySFX is undefined. Which makes sense since it isn't defined - but where does it get defined in the header? Is it part of that Syntax line? the 'int Function play' part I've changed to 'int myFuncName play' and mySFX into myFuncName but that doesn't do anything and more importantly, where do I reference the actual sound file to play?

Sound Property yoursoundhere auto

yoursoundhere.Play

I think.

You need to declare a sound property called mySFX and set the value to the sound you want. In the example, the source is the object on wich the script is attached, but it can be any reference. It's the source of the sound.

There is already a script that play a sound at a select source : DefaultPlaySoundAtLinkSCRIPT

Nevermind, try this instead :

yoursoundhere.Play(Game.GetPlayer())

I've tried the DefaultPlaySoundAtLinkSCRIPT but that didn't work for some reason - nothing would play. I've even tried just a dead simple:

Sound Property MAGVampireSunlightSD Auto>>>>MAGVampireSunlightSD.Play(Self)

But still nothing would play. I'm trying to add a sound effect when an item is equipped but maybe it's being prioritized lower by the default sound effect of equiping/unequiping and item?

I don't have the CK on this computer so I'm going by memory but doesn't most weapons/items have a property/setting in the CK for this exact thing?
Is it the "Pickup sound" and "Putdown sound"? Or is that for something else?

I saw that but I just assumed it was a literal 'pick up' and 'put down' - does it also mean 'equip' and 'unequip'? I'll try it.

You cannot play a sound descriptor, like xxxxxSD. You must use the sound MAGVampireSunlight.

I did try with ID version - the SD version above was a hold over from my next attempt.

You didn't set the volume.

int instanceID = mySFX.play(self)		  ; play mySFX sound from my selfSound.SetInstanceVolume(instanceID, 0.5)		 ; play at half volume

Edit : and don't forget that the sound must be loaded before it can be played and heared. It can take some time if you COC and make the test immediately. Wait 10 seconds before testing after loading your cell.

Got it working as good as it gets with the 'pick up' and 'put down' audio. Thanks guys.