원격 함수 개체는 클라이언트-서버 경계에서 동기적이고 양방향 통신을 용이하게 합니다.사용자 지정 콜백 함수를 정의하고 RemoteFunction:InvokeClient() 또는 RemoteFunction:InvokeServer() 을 호출하여 수동으로 호출할 수 있습니다.함수를 호출하는 코드 는 수신자사람으로부터 응답을 받을 때까지 생성됩니다. 서버와 클라이언트 모두에서 RemoteFunction 인스턴스에 액세스하려면 두 당사자가 볼 수 있는 장소에 있어야 하며, 경우에 따라 ReplicatedStorage 또는 내부의 Workspace 또는 내부의 Tool에 저장하는 것이 적합합니다.
결과가 필요하지 않다면 , 호출이 비동기적이고 응답을 계속 실행하기를 기다릴 필요가 없기 때문에 RemoteEvent 사용하는 것이 좋습니다.리모트 이벤트와 콜백에 대한 코드 샘플과 RemoteFunction에 대한 자세한 내용은 보십시오.
스트리밍 주의 사항
호출된 RemoteFunction 가 서버에 인스턴스를 생성하면 함수가 반환될 때 클라이언트에 존재한다는 보장이 없습니다.이는 플레이어의 캐릭터에서 멀리 떨어진 부분이 클라이언트에 스트리밍되지 않을 수 있고, 부품이 스트리밍되는지 여부에 따라 모델이 의존하기 때문에 인스턴스 스트리밍이 활성화된 장소에서 특히 중요합니다.모델이 Persistent 이더라도 모델의 생성과 클라이언트에 복제되는 시간 사이에 약간의 지연이 있을 수 있습니다.
매개 변수 제한
, 또는 기타 유형의 Roblox 개체는 트리거되는 에서 매개 변수로 전달될 수 있으며, 숫자, 문자열 및 부울과 같은 Luau 유형도 조심스럽게 제한 사항을 조사해야 합니다.
요약
메서드
그 자체에서 RemoteFunction 를 호출하여 OnClientInvoke 콜백을 호출합니다.
그 자체에서 RemoteFunction 를 호출하여 OnServerInvoke 콜백을 호출합니다.
콜백
RemoteFunction를 InvokeClient()로 호출할 때 반환되는 콜백.
RemoteFunction를 InvokeServer()로 호출할 때 반환되는 콜백.
속성
메서드
InvokeClient
그 자체에서 RemoteFunction 를 호출하여 OnClientInvoke 콜백을 호출합니다.이 메서드는 서버에서 클라이언트로 통신하는 데 사용되므로, Script에서만 작동합니다.
, 또는 기타 유형의 Roblox 개체는 매개 변수로 또는 Luau 유형(숫자, 문자열 및 부울과 같은)으로 전달될 수 있지만, 제한 사항을 신중하게 조사해야 합니다.
리모트 이벤트와 콜백에 대한 코드 샘플과 RemoteFunction에 대한 자세한 내용은 보십시오.
주의
실제로 서버는 클라이언트를 자주 호출하지 않으며, 클라이언트는 일반적으로 서버에 없는 정보를 가지고 있지 않고, 클라이언트만 수행할 수 있는 작업(예: GUI 표시)은 일반적으로 콜백이 필요하지 않습니다.따라서 RemoteEvent:FireClient() 는 응답이 계속 실행되기를 기다릴 필요가 없는 비동기 메서드로 권장됩니다.
서버에서 클라이언트를 호출해야 하는 경우 다음 위험을 고려하십시오:
- 클라이언트가 오류를 발생시키면 서버도 오류를 발생시킵니다.
- 클라이언트가 호출되는 동안 연결을 끊으면 InvokeClient() 오류가 발생합니다.
- 클라이언트가 값을 반환하지 않으면 서버는 영원히 유지됩니다.
매개 변수
OnClientInvoke 콜백에 전달할 값.
반환
OnClientInvoke 콜백에서 반환된 값.
InvokeServer
그 자체에서 RemoteFunction 를 호출하여 OnServerInvoke 콜백을 호출합니다.이 메서드는 클라이언트에서 서버로 통신하는 데 사용되므로, LocalScript에서만 작동합니다.
반환된 결과가 필요하지 않은 경우, 비동기적으로 호출되고 응답이 계속 실행되기를 기다릴 필요가 없기 때문에 RemoteEvent:FireServer() 대신 사용하는 것이 좋습니다.
, 또는 기타 유형의 Roblox 개체는 매개 변수로 또는 Luau 유형(숫자, 문자열 및 부울과 같은)으로 전달될 수 있지만, 제한 사항을 신중하게 조사해야 합니다.
리모트 이벤트와 콜백에 대한 코드 샘플과 RemoteFunction에 대한 자세한 내용은 보십시오.
매개 변수
OnServerInvoke 콜백에 전달할 값.
반환
OnServerInvoke 콜백에서 반환된 값.
이벤트
콜백
OnClientInvoke
이 콜백은 RemoteFunction를 사용하여 InvokeClient()로 호출될 때 호출됩니다.바인딩된 함수가 반환되면 반환된 값이 호출 서버로 다시 전송됩니다.
리모트 이벤트와 콜백에 대한 코드 샘플과 OnClientInvoke에 대한 자세한 내용은 보십시오.
매개 변수
InvokeClient()를 통해 전송된 매개변수.
반환
콜백 함수에서 반환된 값.
OnServerInvoke
이 콜백은 RemoteFunction를 사용하여 InvokeServer()로 호출될 때 호출됩니다.바인딩된 함수가 반환되면 반환된 값이 호출 클라이언트에 다시 전송됩니다.
리모트 이벤트와 콜백에 대한 코드 샘플과 OnServerInvoke에 대한 자세한 내용은 보십시오.
매개 변수
클라이언트에서 발생하는 Player 호출과 연결된 클라이언트와 관련된 InvokeServer() 호출 원본.
InvokeServer()를 통해 전송된 매개변수.
반환
콜백 함수에서 반환된 값.