사생활 보호 기능

캠 화면에 블러 처리 또는 가상 배경을 적용합니다.

설치

index.html

<script type="text/javascript" src="https://dev.knowledgetalk.co.kr:7102/uncompressed/privacyMode.js"></script>

인스턴스 생성 및 초기화

const privacyMode = new PrivacyMode();

await privacyMode.init();

사생활 보호 시작

• 예시

const blurStream = await privacyMode.start(
      inputVideo,
      outputCanvas,
      'bg',
      'https://imgUrl...',
);

• 타입

start(
    inputVideo: HTMLVideoElement;
    outputCanvas: HTMLCanvasElement;
    mode: "blur" | "bg";
    bgSrc: string | null;
): Promise<MediaStream>;

• 요청 상세

Parameter	Description	Example
inputVideo	사생활 보호를 적용할 stream	HTMLVideoElement
outputCanvas	사생활 보호가 적용된 결과물을 보여줄 canvas	HTMLCanvasElement
mode	블러 처리 또는 가상 배경	'bg'
bgSrc	가상 배경 이미지 경로	'https://imgUrl...'

• 응답 상세

Parameter	Description	Example
blurStream	사생활 보호가 적용된 stream	MediaStream

• blurStream 과 outputCanvas에 결과물이 표시 됩니다. 필요에 따라 stream 또는 canvas 형식으로 사용할 수 있습니다.

사생활 보호 영상 송신

송신기중인존 스트림을 사생활 보호가 적용된 스트림으로 교체합니다.

• 예시

await privacyMode.sendBlurVideoTrack(knowledgetalk);

• 타입

sendBlurVideoTrack(
    sdk: Knowledgetalk;
    target?: string;    
): Promise<void>;

• 요청 상세

Parameter	Description	Example
sdk	Knowledgetalk SDK 인스턴스	Knowledgetalk
target	p2p의 경우 타겟 유저 아이디	'u1234'

사생활 보호 배경 변경

사생활 보호 시작 후 모드 또는 배경을 변경할 때 호출합니다.

• 예시

await privacyMode.changeBackground('bg', 'https://imageUrl...');

• 타입

changeBackground(
    mode: "blur" | "bg";
    bgUrl: string | null;
): Promise<void>;

• 요청 상세

Parameter	Description	Example
mode	변경할 모드	'bg'
bgUrl	bg모드 일 경우 배경 이미지 경로	'https://imageUrl...'

사생활 보호 요소 업데이트

사생활 보호 진행 중 inputVideo 또는 outputCanvas 요소의 변경이 필요한 경우에만 호출합니다.

• 예시

await privacyMode.update(newInputVideoEl, newOutputCanvas);

• 타입

update(
    inputVideo: HTMLVideoElement;
    outputCanvas: HTMLCanvasElement;
): Promise<MediaStream>;

• 요청 상세

Parameter	Description	Example
inputVideo	변경할 video element	HTMLVideoElement
outputCanvas	변경할 canvas element	HTMLCanvasElement

• 응답 상세

Parameter	Description	Example
blurStream	사생활 보호가 적용된 새로운 stream	MediaStream

사생활 보호 종료

송신 중인 사생활 보호 스트림을 기존 스트림으로 교체하고 사생활 보호를 종료합니다.

• 예시

await privacyMode.stop();