> For the complete documentation index, see [llms.txt](https://docs.roboflow.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roboflow.com/deployment/ko/self-hosted/sdks/web-browser/web-inference-sdk.md).

# 웹 inference-sdk

기존 Serverless Video Streaming 통합을 위한 JavaScript WebRTC 참조입니다. 새 관리형 라이브 카메라 배포에는 Cloud Streaming을 사용하세요.

{% hint style="info" %}
아래의 호스팅 WebRTC 통합은 더 이상 사용되지 않는 [Serverless Video Streaming API](https://docs.roboflow.com/deployment/ko/roboflow-cloud/serverless-api/serverless-video-streaming-api.md)를 사용합니다. 새로운 관리형 라이브 카메라 배포에는 [Cloud Streaming](https://docs.roboflow.com/deployment/ko/roboflow-cloud/cloud-streaming.md)을 사용하세요. Cloud Streaming의 소스, 작업 및 결과 인터페이스는 이 페이지의 WebRTC 메서드와 별개입니다.
{% endhint %}

### WebRTC 스트리밍이란?

`@roboflow/inference-sdk` 를 사용하면 WebRTC를 통해 브라우저에서 Roboflow 추론 서버로 실시간 비디오를 스트리밍할 수 있습니다. 다음과 같은 작업이 가능합니다.

* **워크플로 실행** - 복잡한 다단계 컴퓨터 비전 파이프라인 실행
* **모든 모델에 액세스** - 모든 유형의 Roboflow 모델 사용
* **서버 측 처리** - 강력한 GPU 활용
* **낮은 지연 시간** - WebRTC를 통해 거의 실시간으로 결과 제공
* **양방향 통신** - 스트리밍 중 데이터 송수신

### 설치

```bash
npm install @roboflow/inference-sdk
```

### 빠른 시작

시작하려면 아래 비디오/샘플 코드를 살펴보세요.

{% embed url="<https://www.loom.com/share/48b7c442a69c49e081d0dbec49e1ab57>" %}

```typescript
import { connectors, webrtc, streams } from '@roboflow/inference-sdk';

// ⚠️ 개발 환경에서만 withApiKey 사용
// ⚠️ API 키가 노출되므로 프로덕션에서는 사용하지 마세요
// 프로덕션에서는 백엔드 프록시를 사용하세요(다음 섹션 참조)
const connector = connectors.withApiKey("your-api-key");

// 카메라 스트림 가져오기
const stream = await streams.useCamera({
  video: {
    facingMode: { ideal: "environment" },
    width: { ideal: 640 },
    height: { ideal: 480 }
  }
});

// WebRTC 연결 시작
const connection = await webrtc.useStream({
  source: stream,
  connector,
  wrtcParams: {
    workspaceName: "your-workspace",
    workflowId: "your-workflow",
    imageInputName: "image",
    streamOutputNames: ["output"],
    dataOutputNames: ["predictions"]
  },
  onData: (data) => {
    console.log("Inference results:", data);
  }
});

// 처리된 비디오 표시
const videoElement = document.getElementById('video');
videoElement.srcObject = await connection.remoteStream();

// 완료되면 정리
await connection.cleanup();
```

### 🔐 보안 모범 사례

**프로덕션 애플리케이션의 프런트엔드 코드에 API 키를 절대 노출하지 마세요.**

이 `connectors.withApiKey()`  메서드는 데모에 편리하지만 브라우저에서 API 키가 노출됩니다. **프로덕션 환경에서는 항상 백엔드 프록시를 사용하세요.**

#### 프로덕션 환경의 안전한 패턴

**프런트엔드:**

```typescript
import { connectors, webrtc, streams } from '@roboflow/inference-sdk';

// 직접 API 키를 사용하는 대신 프록시 엔드포인트 사용
const connector = connectors.withProxyUrl('/api/init-webrtc');

const stream = await streams.useCamera({ video: true });
const connection = await webrtc.useStream({
  source: stream,
  connector,
  wrtcParams: { /* ... */ }
});
```

**백엔드(Express):**

```typescript
import { InferenceHTTPClient } from '@roboflow/inference-sdk/api';

app.post('/api/init-webrtc', async (req, res) => {
  const { offer, wrtcparams } = req.body;

  // API 키는 서버에서 안전하게 보관
  const client = InferenceHTTPClient.init({
    apiKey: process.env.ROBOFLOW_API_KEY
  });

  const answer = await client.initializeWebrtcWorker({
    offer,
    workspaceName: wrtcparams.workspaceName,
    workflowId: wrtcparams.workflowId,
    config: {
      imageInputName: wrtcparams.imageInputName,
      streamOutputNames: wrtcparams.streamOutputNames,
      dataOutputNames: wrtcparams.dataOutputNames
    }
  });

  res.json(answer);
});
```

### 주요 기능

#### 출력 동적 재구성

스트림 및 데이터 출력을 다시 시작하지 않고 런타임에 변경할 수 있습니다.

```typescript
// 다른 시각화로 전환
connection.reconfigureOutputs({
  streamOutput: ["blur_visualization"]
});

// 모든 데이터 출력 활성화
connection.reconfigureOutputs({
  dataOutput: ["*"]
});

// 두 출력 모두 한 번에 변경
connection.reconfigureOutputs({
  streamOutput: ["annotated_image"],
  dataOutput: ["predictions", "counts"]
});
```

### 완전한 실행 예제

프런트엔드와 백엔드 코드가 모두 포함된 완전한 실행 예제는 다음을 참조하세요: [샘플 애플리케이션 저장소](https://github.com/roboflow/inferenceSampleApp). 샘플 앱에서 확인할 수 있는 내용:

* API 키 보안을 위한 올바른 백엔드 프록시 설정
* 카메라 스트리밍 통합
* 오류 처리 및 연결 관리
* 프로덕션 환경에 바로 적용 가능한 패턴

### 리소스

* [예제 애플리케이션](https://github.com/roboflow/inferenceSampleApp)
* [NPM 패키지](https://www.npmjs.com/package/@roboflow/inference-sdk)
