버전

menu_open

ak.soundengine.seekOnEvent


Seek inside all playing objects that are referenced in Play Actions of the specified Event. See AK::SoundEngine::SeekOnEvent.

Supported by

Graphical User Interface.

Arguments

Name Type Description
event   Either the ID (GUID), name, or short ID of the Event.
gameObject integer Associated game object ID; use AK_INVALID_GAME_OBJECT to affect all game objects.
position integer Desired position where playback should restart, in milliseconds.
percent number Desired position where playback should restart, expressed in a percentage of the file's total duration, between 0 and 1.f. See note above about infinite looping sounds.
seekToNearestMarker boolean If true, the final seeking position will be made equal to the nearest marker.
playingId integer Specify the playing ID for the seek to be applied to. Will result in the seek happening only on active actions of the playing ID. Use AK_INVALID_PLAYING_ID or nothing, to seek on all active Actions of this Event ID.

Required argument groups:

Arguments Details


event

description : Either the ID (GUID), name, or short ID of the Event.
Possibilities, one of the following :

1) type : string
pattern : ^[a-zA-Z_]+[a-zA-Z_0-9]*$

2) type : string
pattern : ^\{[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}\}$

3) type : integer
minimum : 0
maximum : 4294967295

gameObject

description : Associated game object ID; use AK_INVALID_GAME_OBJECT to affect all game objects.
type : integer
minimum : 0
maximum : 18446744073709551615

position

description : Desired position where playback should restart, in milliseconds.
type : integer
minimum : -2147483648
maximum : 2147483647

percent

type : number
description : Desired position where playback should restart, expressed in a percentage of the file's total duration, between 0 and 1.f. See note above about infinite looping sounds.

seekToNearestMarker

type : boolean
description : If true, the final seeking position will be made equal to the nearest marker.

playingId

description : Specify the playing ID for the seek to be applied to. Will result in the seek happening only on active actions of the playing ID. Use AK_INVALID_PLAYING_ID or nothing, to seek on all active Actions of this Event ID.
type : integer
minimum : 0
maximum : 4294967295


Examples :

Seeking to position 1 s

Seeks on "gameObject" referenced in the Play Action of "event" at 1 second.

Arguments:

{
    "event": "MyEventName", 
    "gameObject": 1122334, 
    "position": 1000, 
    "seekToNearestMarker": false, 
    "playingId": 0
}

Seeking to 35% of duration

Seeks on "gameObject" referenced in the Play Action of "event" at 35% of the duration.

Arguments:

{
    "event": 5566123, 
    "gameObject": 1122334, 
    "percent": 0.35, 
    "seekToNearestMarker": false, 
    "playingId": 321654
}


Detailed JSON Schema


Arguments :

{
    "type": "object", 
    "properties": {
        "event": {
            "description": "Either the ID (GUID), name, or short ID of the Event.", 
            "anyOf": [
                {
                    "type": "string", 
                    "pattern": "^[a-zA-Z_]+[a-zA-Z_0-9]*$"
                }, 
                {
                    "type": "string", 
                    "pattern": *Must be a valid GUID*
                }, 
                {
                    "type": "integer", 
                    "minimum": 0, 
                    "maximum": 4294967295
                }
            ]
        }, 
        "gameObject": {
            "description": "Associated game object ID; use <tt>AK_INVALID_GAME_OBJECT</tt> to affect all game objects.", 
            "type": "integer", 
            "minimum": 0, 
            "maximum": 18446744073709551615
        }, 
        "position": {
            "description": "Desired position where playback should restart, in milliseconds.", 
            "type": "integer", 
            "minimum": -2147483648, 
            "maximum": 2147483647
        }, 
        "percent": {
            "type": "number", 
            "description": "Desired position where playback should restart, expressed in a percentage of the file's total duration, between 0 and 1.f. See note above about infinite looping sounds."
        }, 
        "seekToNearestMarker": {
            "type": "boolean", 
            "description": "If true, the final seeking position will be made equal to the nearest marker."
        }, 
        "playingId": {
            "description": "Specify the playing ID for the seek to be applied to. Will result in the seek happening only on active actions of the playing ID. Use \\c AK_INVALID_PLAYING_ID or nothing, to seek on all active Actions of this Event ID.", 
            "type": "integer", 
            "minimum": 0, 
            "maximum": 4294967295
        }
    }, 
    "oneOf": [
        {
            "required": [
                "event", 
                "gameObject", 
                "position", 
                "seekToNearestMarker", 
                "playingId"
            ]
        }, 
        {
            "required": [
                "event", 
                "gameObject", 
                "percent", 
                "seekToNearestMarker", 
                "playingId"
            ]
        }
    ], 
    "additionalProperties": false
}


Options :

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


Response :

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

Document version : 1


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

지원이 필요하신가요?

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

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

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

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

Wwise를 시작해 보세요