네트워크 통신

Chrome 앱은 TCP 및 UDP 연결을 위한 네트워크 클라이언트 역할을 할 수 있습니다. 이 문서에서는 TCP 및 UDP는 네트워크를 통해 데이터를 주고받습니다. 자세한 내용은 소켓 UDP, Sockets TCP, Sockets TCP Server API입니다.

매니페스트 요구사항

TCP 또는 UDP를 사용하는 Chrome 앱의 경우 매니페스트에 소켓 항목을 추가하고 IP를 지정합니다. 엔드포인트 권한 규칙 예를 들면 다음과 같습니다.

"sockets": {
    "udp": {
      "send": ["host-pattern1", ...],
      "bind": ["host-pattern2", ...],
      ...
    },
    "tcp" : {
      "connect": ["host-pattern1", ...],
      ...
    },
    "tcpServer" : {
      "listen": ["host-pattern1", ...],
      ...
    }
  }

소켓 '호스트 패턴' 구문 다음 규칙을 따릅니다.

<host-pattern> := <host> | ':' <port> | <host> ':' <port>
<host> := '*' | '*.' <anychar except '/' and '*'>+
<port> := '*' | <port number between 1 and 65535>)

구문에 관한 자세한 설명은 소켓 매니페스트 키를 참고하세요.

소켓 매니페스트 항목의 예:

• { "tcp": { "connect" : "*:23" } } - 모든 호스트의 포트 23에서 연결
• { "tcp": { "connect" : ["*:23", "*:80"] } } - 모든 호스트의 포트 23 또는 80에서 연결
• { "tcp": { "connect" : "www.example.com:23" } } - www.example.com의 연결 포트 23
• { "tcp": { "connect" : "" } }–모든 호스트의 포트 연결
• { "udp": { "send" : ":99" } } - 모든 호스트의 포트 99로 UDP 패킷 전송
• { "udp": { "bind" : ":8899" } } - 로컬 포트 8899를 바인딩하여 UDP 패킷 수신
• { "tcpServer": { "listen" : ":8080" } }: 로컬 포트 8080에서 수신 대기하는 TCP

TCP 사용

Chrome 앱은 TCP를 지원하는 모든 서비스에 연결할 수 있습니다.

소켓에 연결

다음은 소켓에 연결 (sockets.tcp.connect)하는 방법을 보여주는 샘플입니다.

chrome.sockets.tcp.create({}, function(createInfo) {
  chrome.sockets.tcp.connect(createInfo.socketId,
    IP, PORT, onConnectedCallback);
});

나중에 데이터를 수신하고 전송할 수 있도록 핸들을 socketId에 유지합니다. (sockets.tcp.send)를 전달할 수 있습니다.

소켓에서 수신 및 소켓으로 전송

(sockets.tcp.onReceive)에서 수신하고 소켓으로 전송할 때는 ArrayBuffer 객체가 사용됩니다. 받는사람 ArrayBuffers에 대해 알아보고 개요, JavaScript 유형 배열, 튜토리얼을 확인하세요. ArrayBuffer를 String으로 변환하거나 String으로 변환하는 방법

chrome.sockets.tcp.send(socketId, arrayBuffer, onSentCallback);

chrome.sockets.tcp.onReceive.addListener(function(info) {
  if (info.socketId != socketId)
    return;
  // info.data is an arrayBuffer.
});

소켓에서 연결 해제

연결을 해제하는 방법은 다음과 같습니다 (sockets.tcp.disconnect).

chrome.sockets.tcp.disconnect(socketId);

UDP 사용

Chrome 앱은 UDP를 지원하는 모든 서비스에 연결할 수 있습니다.

데이터 전송

다음은 UDP를 사용하여 네트워크를 통해 데이터 (sockets.udp.send)를 전송하는 방법을 보여주는 샘플입니다.

// Create the Socket
chrome.sockets.udp.create({}, function(socketInfo) {
  // The socket is created, now we can send some data
  var socketId = socketInfo.socketId;
  chrome.sockets.udp.send(socketId, arrayBuffer,
    '127.0.0.1', 1337, function(sendInfo) {
      console.log("sent " + sendInfo.bytesSent);
  });
});

데이터 수신 중

이 예는 이벤트 핸들러를 설정한다는 점만 빼고요, 데이터를 수신할 수 없습니다.

var socketId;

// Handle the "onReceive" event.
var onReceive = function(info) {
  if (info.socketId !== socketId)
    return;
  console.log(info.data);
};

// Create the Socket
chrome.sockets.udp.create({}, function(socketInfo) {
  socketId = socketInfo.socketId;
  // Setup event handler and bind socket.
  chrome.sockets.udp.onReceive.addListener(onReceive);
  chrome.sockets.udp.bind(socketId,
    "0.0.0.0", 0, function(result) {
      if (result < 0) {
        console.log("Error binding socket.");
        return;
      }
      chrome.sockets.udp.send(socketId, arrayBuffer,
        '127.0.0.1', 1337, function(sendInfo) {
          console.log("sent " + sendInfo.bytesSent);
      });
  });
});

TCP 서버 사용

Chrome 앱은 sockets.tcpServer API를 사용하여 TCP 서버 역할을 할 수 있습니다.

TCP 서버 소켓 만들기

sockets.tcpServer.create를 사용하여 TCP 서버 소켓을 만듭니다.

chrome.sockets.tcpServer.create({}, function(createInfo) {
  listenAndAccept(createInfo.socketId);
});

클라이언트 연결 수락

다음은 TCP 서버에서 연결 (sockets.tcpServer.listen)을 수락하는 방법을 보여주는 샘플입니다. 소켓:

function listenAndAccept(socketId) {
  chrome.sockets.tcpServer.listen(socketId,
    IP, PORT, function(resultCode) {
      onListenCallback(socketId, resultCode)
  });
}

나중에 새 연결을 수락할 수 있도록 socketId에 대한 핸들을 유지합니다. (sockets.tcpServer.onAccept)

var serverSocketId;
function onListenCallback(socketId, resultCode) {
  if (resultCode < 0) {
    console.log("Error listening:" +
      chrome.runtime.lastError.message);
    return;
  }
  serverSocketId = socketId;
  chrome.sockets.tcpServer.onAccept.addListener(onAccept)
}

새 연결이 설정되면 새 TCP의 clientSocketId로 onAccept가 호출됩니다. 연결 클라이언트 소켓 ID는 sockets.tcp API와 함께 사용해야 합니다. 새로운 기본적으로 일시중지됩니다. sockets.tcp.setPaused를 사용하여 일시중지를 해제하여 수신을 시작합니다. 데이터를 수집하는 데 사용됩니다

function onAccept(info) {
  if (info.socketId != serverSocketId)
    return;

  // A new TCP connection has been established.
  chrome.sockets.tcp.send(info.clientSocketId, data,
    function(resultCode) {
      console.log("Data sent to new TCP client connection.")
  });
  // Start receiving data.
  chrome.sockets.tcp.onReceive.addListener(function(recvInfo) {
    if (recvInfo.socketId != info.clientSocketId)
      return;
    // recvInfo.data is an arrayBuffer.
  });
  chrome.sockets.tcp.setPaused(false);
}

클라이언트 연결 수락 중지

서버 소켓 ID에서 sockets.tcp.disconnect를 호출하여 새 연결 수락을 중지합니다.

chrome.sockets.tcpServer.onAccept.removeListener(onAccept);
chrome.sockets.tcpServer.disconnect(serverSocketId);