netcode.io browser
netcode.io helper
이 저장소를 사용하면 브라우저에 채택되기 전에 브라우저 확장을 통해 netcode.io를 사용할 수 있습니다. netcode.io는 멀티플레이어 HTML5 게임을 지원하기 위해 웹 브라우저에서 UDP를 안전하게 사용할 수 있도록 해줍니다. netcode.io에 대한 자세한 내용은 여기에서 확인할 수 있습니다.
netcode.io는 확장을 통해 다음 브라우저에서 지원됩니다.
모바일 플랫폼은 확장 기능이나 기본 메시징을 지원하지 않기 때문에 기본적으로 브라우저에 netcode.io 지원이 나타날 때까지 모바일 장치 지원은 기본적으로 불가능합니다.
이것이 작동하려면 브라우저 확장과 실제 netcode.io 통신을 수행하는 기본 애플리케이션 도우미를 모두 설치해야 합니다. 확장 프로그램은 도우미를 통해 netcode.io를 사용할 수 있도록 브라우저에 제공되는 기본 메시징 API를 사용합니다.
브라우저에서 이를 시험해 보려면 먼저 netcode.io.host 도우미를 빌드하세요.
go get github.com/wirepair/netcodego build - 현재 OS용env GOOS=windows GOARCH=amd64 go build - Windows용으로 빌드(환경 변수를 설정하는 Linux 스타일)env GOOS=linux GOARCH=amd64 go build - Linux용으로 빌드(환경 변수를 설정하는 Linux 스타일)env GOOS=darwin GOARCH=amd64 go build - Mac용으로 빌드(환경 변수를 설정하는 Linux 스타일) ./netcode.io.host
이는 오류 없이 실행되어야 하며 기본 메시징 확장으로 자체적으로 설치되어야 합니다.
이 작업이 완료되면 browserwebext 디렉토리를 압축이 풀린 확장 프로그램으로 추가하십시오.
API는 Javascript 클라이언트에 window.netcode 로 제공됩니다. 기존 if (window.netcode) { ... } 패턴을 사용하여 netcode.io의 가용성을 확인할 수 있습니다.
window.netcode createClient(callback) 라는 하나의 함수를 제공합니다.
netcode.io 프로토콜을 사용하여 보안 UDP 통신에 사용할 수 있는 새로운 netcode.io 클라이언트를 생성합니다. 콜백은 callback(err, client) 형식입니다. err 이 설정된 경우 클라이언트를 생성하는 동안 오류가 발생했습니다( client 는 null이 됩니다). 그렇지 않으면 client 설정되고 err 은 null입니다. 반환된 클라이언트는 Client 의 인스턴스입니다.
protocol ipv4 또는 ipv6 이어야 하며 연결할 수 있는 서버 주소 유형을 결정합니다.
매개변수:
protocol : ipv4 또는 ipv6 .callback : callback(err, client) 형식의 콜백입니다. 여기서 err 은 null 또는 Error 인스턴스이고 client null 또는 Client 인스턴스입니다. 사용자가 netcode.io 도우미를 설치했는지 확인합니다. 콜백은 callback(err, isPresent) 형식이며, 여기서 err 은 null 이거나 Error 인스턴스입니다. 오류가 없으면 isPresent 는 기본 도우미가 설치되었는지 여부를 나타내는 부울입니다.
netcode.io 도우미가 설치되지 않은 경우 사용자에게 https://github.com/RedpointGames/netcode.io-browser/releases/tag/latest로 안내해야 합니다. 여기에서 netcode.io 도우미를 쉽게 설치할 수 있습니다. 몇 번의 클릭.
매개변수:
callback : callback(err, isPresent) 형식의 콜백입니다. 여기서 err 은 null 또는 Error 인스턴스이고 isPresent null 또는 부울입니다. 패킷 수신 및 전송에 대한 초당 틱 수로 표시되는 netcode.io 클라이언트의 틱 속도를 설정합니다. 클라이언트의 틱율은 기본적으로 60 입니다. 즉, 초당 60번입니다.
매개변수:
tickRate : 1 보다 크거나 같은 정수입니다.callback : callback(err) 형식의 콜백입니다. 여기서 err null 이거나 Error 의 인스턴스입니다. 지정된 토큰을 사용하여 netcode.io 서버에 연결합니다. token Uint8Array 의 인스턴스여야 하며 인증 서버에서 받은 netcode.io 토큰을 나타내야 합니다.
netcode.io를 사용하여 임의의 IP 주소로 UDP 패킷을 보낼 수 없습니다. 대신 게임 서버 IP 주소 목록과 인증 서버와 게임 서버 간에 공유되는 개인 키를 사용하여 토큰을 생성하고 서명할 수 있는 netcode.io 라이브러리(또는 호환 가능한 구현)를 사용하는 인증 서버가 있어야 합니다.
가장 일반적인 시나리오에서 인증 서버는 AJAX 요청의 일부로 토큰을 제공합니다. 사용자 계정 시스템을 사용하는 경우 사용자가 게임에 로그인한 후 클라이언트가 연결할 수 있는 서버를 나타내는 토큰과 함께 토큰을 제공합니다.
매개변수:
token : 토큰 데이터를 포함하는 Uint8Array 인스턴스입니다.callback : callback(err) 형식의 콜백입니다. 여기서 err null 이거나 Error 의 인스턴스입니다. packetBuffer 데이터로 하여 연결된 서버에 패킷을 보냅니다. packetBuffer Uint8Array 의 인스턴스여야 합니다.
매개변수:
token : 보낼 패킷 데이터가 포함된 Uint8Array 인스턴스입니다.callback : callback(err) 형식의 콜백입니다. 여기서 err null 이거나 Error 의 인스턴스입니다. 클라이언트의 현재 상태를 문자열로 반환합니다. 반환된 상태는 connected , connectionDenied connectionRequestTimeout , connectionResponseTimeout , 연결응답 connectionTimedOut , connectTokenExpired , disconnected , invalidConnectToken , sendingConnectionRequest , sendingConnectionResponse 또는 destroyed 중 하나입니다.
매개변수:
callback : callback(err, state) 형식의 콜백입니다. 여기서 err 은 null 이거나 Error 인스턴스입니다. state null (오류의 경우)이거나 위에 나열된 상태 중 하나입니다.클라이언트를 삭제하고 서버와의 연결을 끊고 관련 리소스를 모두 정리합니다. 클라이언트가 삭제되면 다시 사용할 수 없습니다.
매개변수:
callback : callback(err) 형식의 콜백입니다. 여기서 err null 이거나 Error 의 인스턴스입니다. 클라이언트에 이벤트 리스너를 추가합니다. 현재 지원되는 유일한 type 은 클라이언트가 서버로부터 패킷을 수신할 때 실행되는 receive 입니다.
receive 의 경우 콜백은 callback(clientId, buffer) 형식입니다. 여기서 clientId 는 원래 인증 서버에서 발행한 클라이언트 식별자이고 buffer Uint8Array 의 인스턴스로 수신된 패킷입니다.
매개변수:
type : 위에 나열된 지원되는 유형 중 하나입니다.callback : type 에 따라 형태가 다른 콜백입니다. 이 호스트 확장 코드는 MIT 라이센스에 따라 제공됩니다.
현재 이 프로젝트의 주요 목표는 다음과 같습니다.
모든 풀 요청은 MIT 라이선스에 따라 제공되어야 합니다.
