버전

menu_open

ak.soundengine.setMultiplePositions


Set multiple positions for a single game object. Setting multiple positions for a single game object is a way to simulate multiple emission sources while using the resources of only one voice. This can be used to simulate wall openings, area sounds, or multiple objects emitting the same sound in the same area. See AK::SoundEngine::SetMultiplePositions.

(Required *)

Supported by

Graphical User Interface.

Arguments

Name Type Description
gameObject * integer Game Object identifier.
positions * array Array of positions to apply.
multiPositionType * integer Use values from AK::SoundEngine::MultiPositionType.


Arguments Details


gameObject

description : Game Object identifier.
type : integer
minimum : 0
maximum : 18446744073709551615

positions

type : array

argsSchema / positions / ...

items

maxItems : 65535
type : object

Name Type Description
position * object A 3D position to set for the game object.



argsSchema / positions / items / ...

position

type : object
description : A 3D position to set for the game object.

Name Type Description
orientationFront * object Orientation of the listener.
orientationTop * object Top orientation of the listener.
position * object Position of the listener



argsSchema / positions / items / position / ...

orientationFront

type : object
description : Orientation of the listener.

Name Type Description
x * number X Position.
y * number Y Position.
z * number Z Position.



argsSchema / positions / items / position / ...

orientationTop

type : object
description : Top orientation of the listener.

Name Type Description
x * number X Position.
y * number Y Position.
z * number Z Position.



argsSchema / positions / items / position / ...

position

type : object
description : Position of the listener

Name Type Description
x * number X Position.
y * number Y Position.
z * number Z Position.




description : Array of positions to apply.

multiPositionType

type : integer
minimum : 0
maximum : 2
description : Use values from AK::SoundEngine::MultiPositionType.


Examples :

Setting multiple positions for a game object.

Sets "gameObject" to multiple positions, as defined in "positions", to simulate multiple sources for one playing sound.

Arguments:

{
    "gameObject": 1122334, 
    "positions": [
        {
            "position": {
                "orientationFront": {
                    "x": 5, 
                    "y": 20, 
                    "z": 10
                }, 
                "orientationTop": {
                    "x": 70, 
                    "y": 150, 
                    "z": 6
                }, 
                "position": {
                    "x": 70, 
                    "y": 150, 
                    "z": 10
                }
            }
        }, 
        {
            "position": {
                "orientationFront": {
                    "x": -50, 
                    "y": 80, 
                    "z": 15
                }, 
                "orientationTop": {
                    "x": 2, 
                    "y": 40, 
                    "z": 6
                }, 
                "position": {
                    "x": 2, 
                    "y": -20, 
                    "z": 400
                }
            }
        }
    ], 
    "multiPositionType": 1
}

Result:

{}


Detailed JSON Schema


Arguments :

{
    "type": "object", 
    "properties": {
        "gameObject": {
            "description": "Game Object identifier.", 
            "type": "integer", 
            "minimum": 0, 
            "maximum": 18446744073709551615
        }, 
        "positions": {
            "type": "array", 
            "items": {
                "maxItems": 65535, 
                "type": "object", 
                "properties": {
                    "position": {
                        "type": "object", 
                        "description": "A 3D position to set for the game object.", 
                        "properties": {
                            "orientationFront": {
                                "type": "object", 
                                "description": "Orientation of the listener.", 
                                "properties": {
                                    "x": {
                                        "type": "number", 
                                        "description": "X Position."
                                    }, 
                                    "y": {
                                        "type": "number", 
                                        "description": "Y Position."
                                    }, 
                                    "z": {
                                        "type": "number", 
                                        "description": "Z Position."
                                    }
                                }, 
                                "required": [
                                    "x", 
                                    "y", 
                                    "z"
                                ], 
                                "additionalProperties": false
                            }, 
                            "orientationTop": {
                                "type": "object", 
                                "description": "Top orientation of the listener.", 
                                "properties": {
                                    "x": {
                                        "type": "number", 
                                        "description": "X Position."
                                    }, 
                                    "y": {
                                        "type": "number", 
                                        "description": "Y Position."
                                    }, 
                                    "z": {
                                        "type": "number", 
                                        "description": "Z Position."
                                    }
                                }, 
                                "required": [
                                    "x", 
                                    "y", 
                                    "z"
                                ], 
                                "additionalProperties": false
                            }, 
                            "position": {
                                "type": "object", 
                                "description": "Position of the listener", 
                                "properties": {
                                    "x": {
                                        "type": "number", 
                                        "description": "X Position."
                                    }, 
                                    "y": {
                                        "type": "number", 
                                        "description": "Y Position."
                                    }, 
                                    "z": {
                                        "type": "number", 
                                        "description": "Z Position."
                                    }
                                }, 
                                "required": [
                                    "x", 
                                    "y", 
                                    "z"
                                ], 
                                "additionalProperties": false
                            }
                        }, 
                        "required": [
                            "orientationFront", 
                            "orientationTop", 
                            "position"
                        ], 
                        "additionalProperties": false
                    }
                }, 
                "required": [
                    "position"
                ], 
                "additionalProperties": false
            }, 
            "description": "Array of positions to apply."
        }, 
        "multiPositionType": {
            "type": "integer", 
            "minimum": 0, 
            "maximum": 2, 
            "description": "Use values from <tt>AK::SoundEngine::MultiPositionType</tt>."
        }
    }, 
    "required": [
        "gameObject", 
        "positions", 
        "multiPositionType"
    ], 
    "additionalProperties": false
}


Options :

{
    "type": "object", 
    "required": [], 
    "properties": {}, 
    "additionalProperties": false
}


Response :

{
    "type": "object", 
    "properties": {}, 
    "additionalProperties": false
}

Document version : 1


이 페이지가 도움이 되었나요?

지원이 필요하신가요?

질문이 있으신가요? 문제를 겪고 계신가요? 더 많은 정보가 필요하신가요? 저희에게 문의해주시면 도와드리겠습니다!

지원 페이지를 방문해 주세요

작업하는 프로젝트에 대해 알려주세요. 언제든지 도와드릴 준비가 되어 있습니다.

프로젝트를 등록하세요. 아무런 조건이나 의무 사항 없이 빠른 시작을 도와드리겠습니다.

Wwise를 시작해 보세요