Effects SDK

1) 고객 ID (라이선스/평가판) 받기: Effects SDK 개발자 포털(effectssdk.ai)에 등록하여 고객 ID를 생성하고, 가격을 확인하고, 평가판을 활성화하세요. SDK는 HTTPS 요청을 통해 인증하므로 유효한 고객 ID 없이는 실행되지 않습니다.

2) 플랫폼 및 통합 방법 선택: Effects SDK는 웹/WebRTC(JS + WASM), Windows/macOS(C++), iOS(Objective-C 래퍼/Swift 패키지가 있는 C++), Android(Kotlin 래퍼가 있는 C++)에서 사용할 수 있습니다. 제품 및 렌더링 파이프라인(CPU/GPU, DirectX/OpenGL/Metal 등)에 맞는 SDK를 선택하세요.

3) 웹: SDK 설치 (NPM 옵션): 웹 프로젝트에서 패키지를 설치합니다: `npm i effects-sdk`. 이는 비디오 효과 파이프라인을 초기화하고 제어하는 데 사용되는 `tsvb` 클래스를 제공합니다.

4) 웹: 또는 스크립트 태그를 통해 로드 (CDN 옵션): 페이지에 SDK 스크립트를 추가합니다: `<script crossorigin="anonymous" src="https://effectssdk.ai/sdk/web/{VERSION}/tsvb-web.js"></script>`. 그런 다음 `window.tsvb`를 통해 액세스할 수 있습니다.

5) 웹: 고객 ID로 SDK 인스턴스 생성: NPM: `import { tsvb } from 'effects-sdk'; const sdk = new tsvb('{CUSTOMER_ID}');` 스크립트 태그: `const sdk = new window.tsvb('{CUSTOMER_ID}');`

6) 웹: 런타임 옵션 (프리셋/프로바이더) 및 WASM URL 구성: `sdk.config(...)`를 호출하고 WASM 파일 버전이 SDK 버전과 일치하는지 확인합니다. WASM 경로는 전체 URL이어야 합니다. 예: `sdk.config({ preset: 'balanced', provider: 'webgpu', test_inference: true, cache_models: true, wasmPaths: { 'ort-wasm.wasm': 'https://effectssdk.ai/sdk/web/{VERSION}/ort-wasm.wasm', 'ort-wasm-simd.wasm': 'https://effectssdk.ai/sdk/web/{VERSION}/ort-wasm-simd.wasm' } });`

7) 웹: 모델/리소스 사전 로드 (선택적으로 캐시): 첫 사용 지연 시간을 줄이기 위해 SDK를 예열합니다: `sdk.preload();` 선택적으로 구성(`cache_models: true`)을 통해 캐싱을 활성화하거나, 버전에 따라 `sdk.cache()`를 호출합니다.

8) 효과를 적용하기 전에 SDK가 준비될 때까지 기다립니다.: SDK가 준비 신호를 보낸 후에만 효과 구성을 적용합니다(문서에는 `onReady` 콜백이 실행된 후에 구성이 적용되어야 한다고 명시되어 있습니다).

9) 카메라 스트림 연결 (웹/WebRTC 사용): SDK의 스트림 모드를 사용하여 MediaStream을 입력 소스로 제공합니다(문서에는 `useStream()`이 수동 프레임 처리와 상호 배타적인 모드로 참조되어 있습니다). 이는 파이프라인을 다시 생성하고 필요한 리소스를 로드한 다음 `onReady`를 트리거합니다.

10) 원하는 효과 활성화 (흐림, 배경 교체, 미화, 자동 프레이밍 등): SDK의 효과 구성 API를 사용하여 배경 흐림, 가상 배경(이미지/비디오), 미화/피부 매끄럽게, AI 노이즈 제거, AI 색상 보정, 지능형 카메라 프레이밍(스마트 줌)과 같은 기능을 활성화합니다. 런타임에 매개변수를 적용하고 조정합니다(예: 흐림 강도).

11) 대안: 프레임 수동 처리 (VideoFrame 모드): MediaStream 파이프라인을 사용하고 싶지 않다면, 프레임 프로세서 모드를 사용하여 `VideoFrame` 객체를 직접 처리하세요. `processFrame(inputFrame)`을 호출하고 처리된 `VideoFrame`을 받습니다. 중요: 입력 `VideoFrame`은 실패하더라도 SDK에 의해 사용/닫히므로 재사용하지 마십시오.

12) 실시간 성능을 위한 백프레셔 제어 구현: SDK는 동시에 최대 ~2개의 프레임을 처리할 수 있습니다. 처리 중인 프레임을 추적하고, 한도를 초과하는 들어오는 프레임을 드롭하여 메모리 축적을 방지하고 지연 시간을 낮게 유지합니다.

13) 스트림 변경 시 효과 상태 복원 처리: SDK는 내부적으로 구성 상태를 유지하지 않습니다. 카메라 스트림이 변경되면 저장된 구성을 다시 적용해야 합니다(필요에 따라 효과 재구성).

14) 통화 흐름을 방해하지 않고 일시적으로 효과 비활성화: 처리 과정을 우회해야 할 때(예: 성능 제약), SDK의 처리를 중지하여 원본 스트림이 통과하도록 합니다. 오디오 SDK의 경우, 문서에는 우회를 위해 `stop`을 호출하고 다시 활성화를 위해 `run()`을 호출한다고 명시되어 있습니다. 비디오에서도 지원되는 경우 동일한 운영 패턴을 적용합니다.

15) 대상 장치에 대한 성능/품질 조정: 사용자 하드웨어에 적합한 프리셋(예: `balanced`) 및 프로바이더(예: `webgpu`)를 선택합니다. SDK는 플랫폼 전반에 걸쳐 GPU 가속을 지원합니다(DirectX/OpenGL/Metal; OpenVINO/WinML/CoreML 해당 시).

16) 완료 시 리소스 정리: 사용자가 통화를 종료하거나 더 이상 효과가 필요하지 않을 때 `sdk.destroy()`를 호출합니다. 이는 WebGL 컨텍스트를 포함한 리소스를 정리하고 메모리 누수를 방지하는 데 도움이 됩니다. `destroy()` 후에는 SDK를 다시 사용하기 위해 새 인스턴스를 생성합니다.