UO.GetScriptPath

ClassicUO • Runtime API

활성 실행의 소스 파일 경로를 읽습니다.

정확한 구문

UO.GetScriptPath(ScriptIndex:Any) -> String

매개변수

• ScriptIndex — 필수 ScriptIndex는 최신 GetScriptsList에서 얻는 0부터 시작하는 정수 인덱스입니다. 음수이거나 없는 인덱스는 명시된 빈 값/알 수 없음 결과를 반환합니다. 아이템 serial, 프로시저 이름 또는 IDE 실행 ID를 전달하지 마세요.

반환값

String: 저장된 소스 파일 경로이며, 인덱스가 없으면 ""입니다. 파일 시작은 보통 전체 경로를 가지지만 명령이나 메모리의 소스에는 일반 파일이 없을 수 있습니다.

동작

• 실행 중 및 일시 정지된 실행을 포함하며, 끝났거나 취소가 요청된 실행은 제외합니다. 호출 스크립트는 보통 자신도 셉니다. 로드만 한 IDE 탭은 실행이 아닙니다.
• 인덱스는 시작 순서에 따른 현재 위치입니다. 시작/중지로 위치가 바뀔 수 있습니다. 별도 호출은 하나의 원자적 스냅샷이 아니므로 나중에 제어하기 전에 목록을 다시 읽으세요.
• Basic IDE를 닫아도 활성 실행은 사라지지 않습니다. 이 명령들은 다른 클라이언트나 Windows 프로세스가 아닌 이 클라이언트를 조회합니다.
• GetScriptsList는 인덱스, GetScriptsCount는 개수, GetScriptState는 세 상태 코드를 반환합니다. 서로 바꾸어 쓰거나 모든 0이 아닌 값을 true로 해석하지 마세요.
• ScriptIndex=0은 현재 첫 실행을 선택합니다. 소스 경로를 읽을 뿐 파일을 열거나 저장하거나 실행하지 않습니다.

내부 함수: 호출부터 결과까지

아래는 클라이언트의 실제 메서드입니다. Basic 예제에는 완전한 보조 함수가 있으며 내부 C# 메서드 이름은 추가 스크립트 명령이 아닙니다.

1. ExecuteStealthCompatibility

Runtime은 등록된 UO 호출을 실행하고 브리지 결과를 Integer, String 또는 Array로 감쌉니다.

String: 저장된 소스 파일 경로이며, 인덱스가 없으면 ""입니다. 파일 시작은 보통 전체 경로를 가지지만 명령이나 메모리의 소스에는 일반 파일이 없을 수 있습니다.

프로젝트 소스: external/InjectionScript/src/InjectionScript/Runtime/InjectionApiUO.cs; 함수 ExecuteStealthCompatibility.

2. GetScriptPath

브리지는 이 클라이언트의 실행 관리자에 위임합니다.

ScriptIndex=0은 현재 첫 실행을 선택합니다. 소스 경로를 읽을 뿐 파일을 열거나 저장하거나 실행하지 않습니다.

프로젝트 소스: src/ClassicUO.Client/Game/Managers/ClassicUOInjectionApiBridge.cs; 함수 GetScriptPath.

3. GetScriptPath

ElementAt(RunningScripts(), index)?.FilePath ?? string.Empty

인덱스는 시작 순서에 따른 현재 위치입니다. 시작/중지로 위치가 바뀔 수 있습니다. 별도 호출은 하나의 원자적 스냅샷이 아니므로 나중에 제어하기 전에 목록을 다시 읽으세요.

프로젝트 소스: src/ClassicUO.Client/Game/Managers/YokoInjectionManager.cs; 함수 GetScriptPath.

Basic IDE를 닫아도 활성 실행은 사라지지 않습니다. 이 명령들은 다른 클라이언트나 Windows 프로세스가 아닌 이 클라이언트를 조회합니다.

예제

첫 호출과 결과

# 첫 호출과 결과
#
# 활성 실행의 소스 파일 경로를 읽습니다.
#
# String: 저장된 소스 파일 경로이며, 인덱스가 없으면 ""입니다. 파일 시작은 보통 전체 경로를 가지지만 명령이나 메모리의 소스에는 일반 파일이 없을 수 있습니다.

SUB Main()
    # Sub Main을 실행합니다. 전달한 0은 인덱스이며 빈 괄호는 인수가 없다는 뜻입니다. Print 문자열은 예제 메시지일 뿐입니다.
    # ScriptIndex=0은 현재 첫 실행을 선택합니다. 소스 경로를 읽을 뿐 파일을 열거나 저장하거나 실행하지 않습니다.
    # String: 저장된 소스 파일 경로이며, 인덱스가 없으면 ""입니다. 파일 시작은 보통 전체 경로를 가지지만 명령이나 메모리의 소스에는 일반 파일이 없을 수 있습니다.
    # 필수 ScriptIndex는 최신 GetScriptsList에서 얻는 0부터 시작하는 정수 인덱스입니다. 음수이거나 없는 인덱스는 명시된 빈 값/알 수 없음 결과를
    # 반환합니다. 아이템 serial, 프로시저 이름 또는 IDE 실행 ID를 전달하지 마세요.

    Dim index=0
    Dim path=UO.GetScriptPath(index)
    If path<>"" Then
        UO.Print(path)
    End If
END SUB

매개변수 및 실행 설명:

• Sub Main을 실행합니다. 전달한 0은 인덱스이며 빈 괄호는 인수가 없다는 뜻입니다. Print 문자열은 예제 메시지일 뿐입니다.
• ScriptIndex=0은 현재 첫 실행을 선택합니다. 소스 경로를 읽을 뿐 파일을 열거나 저장하거나 실행하지 않습니다.
• String: 저장된 소스 파일 경로이며, 인덱스가 없으면 ""입니다. 파일 시작은 보통 전체 경로를 가지지만 명령이나 메모리의 소스에는 일반 파일이 없을 수 있습니다.
• 필수 ScriptIndex는 최신 GetScriptsList에서 얻는 0부터 시작하는 정수 인덱스입니다. 음수이거나 없는 인덱스는 명시된 빈 값/알 수 없음 결과를 반환합니다. 아이템 serial, 프로시저 이름 또는 IDE 실행 ID를 전달하지 마세요.

반복문 또는 조건에서 사용

# 반복문 또는 조건에서 사용
#
# 활성 실행의 소스 파일 경로를 읽습니다.
#
# String: 저장된 소스 파일 경로이며, 인덱스가 없으면 ""입니다. 파일 시작은 보통 전체 경로를 가지지만 명령이나 메모리의 소스에는 일반 파일이 없을 수 있습니다.

SUB Main()
    # 여러 명령을 조합한 독립적인 예제입니다. 배열 인덱스는 0부터 시작하므로 접근 전에 길이를 확인하세요. Wait(250)이 있으면 250밀리초 기다립니다.
    # ScriptIndex=0은 현재 첫 실행을 선택합니다. 소스 경로를 읽을 뿐 파일을 열거나 저장하거나 실행하지 않습니다.
    # String: 저장된 소스 파일 경로이며, 인덱스가 없으면 ""입니다. 파일 시작은 보통 전체 경로를 가지지만 명령이나 메모리의 소스에는 일반 파일이 없을 수 있습니다.
    # 필수 ScriptIndex는 최신 GetScriptsList에서 얻는 0부터 시작하는 정수 인덱스입니다. 음수이거나 없는 인덱스는 명시된 빈 값/알 수 없음 결과를
    # 반환합니다. 아이템 serial, 프로시저 이름 또는 IDE 실행 ID를 전달하지 마세요.

    Dim indices=UO.GetScriptsList()
    For Each index In indices
        UO.Print(UO.GetScriptName(index) & " -> " & UO.GetScriptPath(index))
    Next
END SUB

매개변수 및 실행 설명:

• 여러 명령을 조합한 독립적인 예제입니다. 배열 인덱스는 0부터 시작하므로 접근 전에 길이를 확인하세요. Wait(250)이 있으면 250밀리초 기다립니다.
• ScriptIndex=0은 현재 첫 실행을 선택합니다. 소스 경로를 읽을 뿐 파일을 열거나 저장하거나 실행하지 않습니다.
• String: 저장된 소스 파일 경로이며, 인덱스가 없으면 ""입니다. 파일 시작은 보통 전체 경로를 가지지만 명령이나 메모리의 소스에는 일반 파일이 없을 수 있습니다.
• 필수 ScriptIndex는 최신 GetScriptsList에서 얻는 0부터 시작하는 정수 인덱스입니다. 음수이거나 없는 인덱스는 명시된 빈 값/알 수 없음 결과를 반환합니다. 아이템 serial, 프로시저 이름 또는 IDE 실행 ID를 전달하지 마세요.

완전한 보조 함수

# 완전한 보조 함수
#
# 활성 실행의 소스 파일 경로를 읽습니다.
#
# String: 저장된 소스 파일 경로이며, 인덱스가 없으면 ""입니다. 파일 시작은 보통 전체 경로를 가지지만 명령이나 메모리의 소스에는 일반 파일이 없을 수 있습니다.

SUB Main()
    # Main 아래에 함수 전체가 있습니다. 이 함수의 인수와 반환값은 내부에서 쓰는 API 명령과 구분해 설명합니다.
    # ReadScriptPath는 경로가 비었을 때만 fallback을 사용합니다. GetScriptPath의 새 오버로드가 아닙니다.
    # String: 저장된 소스 파일 경로이며, 인덱스가 없으면 ""입니다. 파일 시작은 보통 전체 경로를 가지지만 명령이나 메모리의 소스에는 일반 파일이 없을 수 있습니다.
    # 필수 ScriptIndex는 최신 GetScriptsList에서 얻는 0부터 시작하는 정수 인덱스입니다. 음수이거나 없는 인덱스는 명시된 빈 값/알 수 없음 결과를
    # 반환합니다. 아이템 serial, 프로시저 이름 또는 IDE 실행 ID를 전달하지 마세요.

    UO.Print(ReadScriptPath(0, "path unavailable"))
END SUB

Function ReadScriptPath(index, fallback) As String
    Dim path=UO.GetScriptPath(index)
    If path="" Then
        Return fallback
    End If
    Return path
End Function

매개변수 및 실행 설명:

• Main 아래에 함수 전체가 있습니다. 이 함수의 인수와 반환값은 내부에서 쓰는 API 명령과 구분해 설명합니다.
• ReadScriptPath는 경로가 비었을 때만 fallback을 사용합니다. GetScriptPath의 새 오버로드가 아닙니다.
• String: 저장된 소스 파일 경로이며, 인덱스가 없으면 ""입니다. 파일 시작은 보통 전체 경로를 가지지만 명령이나 메모리의 소스에는 일반 파일이 없을 수 있습니다.
• 필수 ScriptIndex는 최신 GetScriptsList에서 얻는 0부터 시작하는 정수 인덱스입니다. 음수이거나 없는 인덱스는 명시된 빈 값/알 수 없음 결과를 반환합니다. 아이템 serial, 프로시저 이름 또는 IDE 실행 ID를 전달하지 마세요.

---

en · ru · uk · fr · de · it · es · zh-tw · ja · ko

Basic