위젯 작업 > 2D > 오디오
  
오디오
이 위젯의 기능은 무엇인가요?
오디오 위젯을 사용하면 경험 내에서 오디오 파일을 재생할 수 있습니다. 지원되는 파일 유형은 다음과 같습니다.
.wav
.mp3
.mp4
이 위젯은 언제 사용해야 하나요?
다음과 같은 경우 오디오 위젯을 사용합니다.
오디오를 사용자의 경험에 포함하려고 합니다.
경험의 경우 사용자가 양손을 사용하여 작업을 완료해야 합니다. 예를 들어 서비스 기술자가 생성기의 오일을 변경하려는 경우 장치에서 변경 정치를 읽거나 종이 설명서를 살펴볼 필요 없이 해당 절차의 오디오를 재생할 수 있습니다.
특별한 속성, 서비스, 이벤트 또는 작업이 있나요?
공통적인 위젯 속성, 서비스 및 이벤트 목록을 보려면 공통적인 위젯 속성, 서비스 및 이벤트 항목을 참조하십시오.
다음 테이블은 이 위젯에 한정된 속성, 서비스 및 이벤트 목록을 제시합니다.
속성
JavaScript
유형
설명
오디오 소스
audiosrc
string
오디오를 포함하려면 다음 중 한 가지를 수행하십시오.
필드 옆의 를 클릭하여 새 오디오 파일을 추가합니다.
오디오 URL을 필드에 입력하거나 복사하여 직접 붙여 넣습니다.
드롭다운 메뉴에서 오디오 파일을 선택합니다.
원격 미디어 연결에 대한 자세한 내용은 원격 미디어에 연결 항목을 참조하십시오.
컨트롤 표시
showcontrols
boolean
컨트롤 표시 여부를 선택합니다.
미리 로드
preload
string
미리 로드할 항목을 선택합니다.
콘텐츠
메타데이터만
없음
재생 중
isPlaying
boolean
오디오 재생 여부를 표시합니다.
서비스
JavaScript
설명
재생
play
오디오를 재생하는 바인딩 가능 서비스입니다.
일시 중지
pause
오디오를 일시 중지하는 바인딩 가능 서비스입니다.
이벤트
JavaScript
설명
재생 시작됨
playStarted
오디오가 시작되면 트리거됩니다.
재생 일시 중지됨
playPaused
오디오가 일시 중지되면 트리거됩니다.
재생 종료됨
playEnded
오디오가 종료되면 트리거됩니다.
위젯 작동
본 예는 위젯의 작동 장면입니다.
사용에 필요한 최소 단계
작동 장면
1. 오디오 위젯을 캔버스로 끌어서 놓습니다.
2. 오디오 소스 필드에서 오디도 리소스를 선택 또는 추가합니다.
* 
본 예에서는 세부 정보 창의 미리 로드 드롭다운에서 콘텐츠를 선택하여 열린 경험에 콘텐츠를 즉시 표시하도록 선택했습니다.