
Xodera Plugins · Bubble Native
Xodera Audio Player Native
수업, 음성 메시지 또는 제품 기록에 명확한 오디오 플레이어를 추가합니다. 사용자가 듣고, 속도를 조절하며 저장된 위치에서 계속 재생할 수 있게 합니다.
Public beta guides · Haptics instructions are in its Bubble listing
Public beta offer: free Bubble install · 7-day card trial, then US$1.50/month per plugin/project.
문서 검토일: 2026년 11월 6일
실용적인 예시
지원 대화 내의 음성 메모
일반 파일 링크는 사용자를 대화 밖으로 보내며 긴 답변을 검토하기 어렵게 합니다.
`source_url = Selected Message’s audio URL`; `title = Selected Message’s sender label`; `subtitle = Selected Message’s timestamp`.
선택된 메시지 상세에 플레이어를 배치합니다. 사용자가 Play/Pause, Seek를 유용한 지점까지 수행하고 Set speed하도록 합니다. `is_active`를 열린 대화에 바인딩합니다.
진행 상황을 표시하려면 `is_playing`, `current_time` 및 `duration`를 사용하십시오. 늦은 이벤트가 다른 대화를 업데이트하지 못하도록 Message ID를 앱에 보관하십시오.
`player_error`가 발생하면 `error_code`를 표시하고 Reload source를 제공하십시오; 메시지를 보존하고 오류 후에는 절대 청취 완료로 표시하지 마십시오.
재생 전용. 앱이 청취 진행을 저장합니다.
저장된 위치에서 언어 수업을 재개합니다
학습자는 전체 수업을 다시 시작하는 대신 어려운 구절을 다시 재생해야 합니다.
`source_url = Current Lesson’s audio URL`; `title = Current Lesson’s name`; 마지막 위치는 데이터베이스의 해당 학습자와 수업에 속합니다.
현재 수업에 대해 `ready` 후, 저장된 초까지 Seek하고 사용자가 Play할 때까지 기다립니다. 느린 청취를 위해 Set speed를 사용하십시오. 자체 앱 워크플로우로 진행을 저장합니다.
`current_time`와 `duration`를 읽으십시오. `playback_ended`가 발생하면 앱이 현재 Lesson에 대한 청취 이정표를 기록할 수 있습니다.
소스가 변경된 경우 해당 수업이 로드될 때까지 이전 위치를 버리십시오. 청취 완료를 학습자가 이해했거나 시험에 합격했다는 증거로 간주하지 마십시오.
재생 전용. 앱이 청취 진행을 저장합니다.
타임스탬프가 있는 댓글과 함께 오디오 첨부 파일을 검토합니다
편집자 또는 트레이너는 댓글에서 녹음의 관련 순간으로 이동해야 합니다.
`source_url = Selected Review’s recording URL`; 각 앱 소유 댓글은 자체 초 값을 저장합니다; 선택적 `waveform_peaks_json`에는 동일 녹음에 대한 실제 피크가 포함됩니다.
댓글을 클릭 → Seek를 해당 초로 → Play합니다. 소스가 변경되면 피크를 교체하거나 삭제하고 선택된 리뷰를 다시 바인딩합니다.
댓글 작성기 옆에 `current_time`를 표시합니다. `waveform_available`는 UI에 실제 제공된 피크가 사용 가능한지 알려줍니다.
오래된 타임스탬프를 앱의 현재 재생 시간 범위 안으로 제한하거나 거부하세요. 실제 피크가 없으면 임의로 만든 오디오 분석 대신 일반 진행 컨트롤을 표시하세요.
재생 전용. 앱이 청취 진행을 저장합니다.
현재 작동 중인 항목
Public beta. Use the documented controls and actions; test supported formats, permissions and device behavior in your own native app. Browser preview does not validate native device output.
워크플로우 만들기
아래 제공된 베타 액션을 사용하고 대상 디바이스에서 결과를 테스트하십시오.
이 예제들은 Lesson, Message 및 Order와 같은 앱 레코드를 사용합니다. 이를 귀하의 데이터 유형 및 요소 이름으로 교체하십시오. 예시 미디어 주소는 귀하의 파일로 교체해야 합니다.
오디오 요소를 추가하십시오. source_url = Selected Message's audio_url, title = Selected Message's sender_label 및 subtitle = Selected Message's date_label를 설정하세요.
이 녹음에 대한 실제 파형 데이터가 있으면 waveform_peaks_json에 전달하십시오. 없으면 비워두세요.
ready 이벤트가 발생하면 필요에 따라 저장된 초 값으로 Seek를 사용하세요. 사용자가 Play를 누르게 하세요. 플레이어 버튼에는 Pause, Seek 및 Set speed를 사용하세요.
current_time과 duration을 표시하세요. playback_ended가 발생하면 선택된 메시지 또는 수업의 청취 진행 상황을 저장하세요. 이 화면이 열려 있는지 여부를 is_active에 설정하세요.
한 번만 설정
BestPlugins → Dashboard → Plugins에서 Bubble 앱 프로젝트를 만들거나 선택하십시오. Xodera Audio Player Native를 선택하고 키를 복사한 다음 Bubble → Plugins → Xodera Audio Player Native를 열어 licensing_api_key에 붙여넣으세요. 한 번 저장한 후 아래 액션을 사용하십시오. 각 프로젝트의 각 플러그인마다 고유한 키가 있습니다.
앱이 열 수 있는 직접 오디오 파일 주소를 사용하십시오. 오디오 재생에는 마이크나 카메라 접근 권한이 필요하지 않습니다.
한 번만 설정
- BestPlugins → Dashboard → Plugins에서 Bubble 앱 프로젝트를 만들거나 선택하십시오.
- 이 플러그인을 선택하고 프로젝트 키를 복사하십시오.
- Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
- 요소를 추가하고 앱 데이터를 선택한 뒤 아래 워크플로우를 구축하십시오.
- In the dashboard, review and confirm the 7-day card trial for this plugin. It then costs US$1.50/month per app project, including development and production. Cancel before the trial ends to avoid the first charge.
설치 및 구독
For Audio Player, Video Player, Photo Editor, Audio Recorder, Files Kit and Haptics: free Bubble installation, a 7-day trial with a card, then US$1.50 per month per plugin and app project. Development and production are included, with no operation cap. File-size and feature limits still apply. Review billing and cancellation before confirming. Other plugins remain unavailable for purchase.
결과를 앱에 저장
예시 ListeningProgress: owner = Current User, lesson = Selected Lesson, seconds = Audio Player's current_time, duration = Audio Player's duration. 매 화면 업데이트마다가 아니라 사용자가 일시 중지하거나 수업을 떠날 때 저장하십시오.
실패, 취소 및 복구
player_error에서 error_code를 표시하고 Reload source를 제공합니다. 메시지 또는 수업 기록을 유지합니다. 다른 녹음이 선택되면 해당 저장된 위치를 로드합니다. 뷰로 돌아올 때 자동으로 재생이 시작되지 않습니다.
기능 및 제한
재생 속도: 1, 1.5 및 2. 볼륨: 0–1. 파형 데이터: 2–2048, 값은 0와 1 사이입니다. 지원되는 오디오 형식은 디바이스에 따라 다릅니다. 플레이어는 오디오를 녹음, 전사하거나 오프라인 사용을 위해 영구 저장하지 않습니다. 백그라운드 및 잠금 화면 재생은 보장되지 않습니다.
설정, 액션 및 결과
Bubble에서 이러한 이름을 사용하세요. 예정 기능은 별도로 표시됩니다.
사용 가능한 베타 설정
요소 설정
source_url · textwaveform_peaks_json · texttitle · textsubtitle · textplayback_rate · numbervolume · numberloop · yes_nois_active · yes_nodisabled · yes_noui_text_json · textlanguage · text상태
player_status · textis_playing · yes_nois_loaded · yes_nois_buffering · yes_nocurrent_time · numberduration · numberprogress · numberplayback_rate · numbervolume · numberis_looping · yes_nowaveform_available · yes_nowaveform_status · texterror_code · text이벤트
readyplayback_startedplayback_pausedplayback_endedseek_completedrate_changedplayer_error액션 및 입력값
PlayPauseToggleStopSeekSet speedSet volumeReload source요소 설정 · 11
source_urltext · 기본값: ""- 예시 값
https://bestplugins.online/native-samples/lesson.mp3 - 예시 Bubble 표현
Selected Message's audio_url - 선택한 오디오, 비디오 또는 이미지 파일의 주소입니다. 이 플러그인이 지원하는 파일 형식을 사용하십시오.
waveform_peaks_jsontext · 기본값: ""- 예시 값
[0.1,0.4,0.2,0.7] - 예시 Bubble 표현
Selected Message's waveform_peaks_json - 이 녹음의 실제 정규화된 진폭 값입니다; 사용할 수 없으면 비워 두세요.
titletext · 기본값: ""- 예시 값
Lesson 4 — review - 예시 Bubble 표현
Selected Lesson's name - 보이는 앱 텍스트; 비워 두면 지원되는 경우 내장된 현지화된 복사본을 사용합니다. 자격 증명 없음.
subtitletext · 기본값: ""- 예시 값
Teacher · today - 예시 Bubble 표현
Selected Message's sender_label - 보이는 앱 텍스트; 비워 두면 지원되는 경우 내장된 현지화된 복사본을 사용합니다. 자격 증명 없음.
playback_ratenumber · 기본값: 1- 예시 값
1.5 - 예시 Bubble 표현
Current User's listening_speed - 현재 비즈니스 레코드의 값을 사용하고, 아래 제한과 비교해 검증하십시오.
volumenumber · 기본값: 1- 예시 값
0.8 - 예시 Bubble 표현
Volume Slider's value - 현재 비즈니스 레코드의 값을 사용하고, 아래 제한과 비교해 검증하십시오.
loopyes_no · 기본값: false- 예시 값
no - 예시 Bubble 표현
Selected Lesson's repeat_enabled - 현재 비즈니스 레코드의 값을 사용하고, 아래 제한과 비교해 검증하십시오.
is_activeyes_no · 기본값: true- 예시 값
yes - 예시 Bubble 표현
GuideHost's view_is_active (your yes/no custom state) - 이 뷰가 열려 있는 동안 yes로 설정하고, 떠날 때 no로 설정하여 재생 또는 현재 작업이 중지될 수 있게 합니다.
disabledyes_no · 기본값: false- 예시 값
no - 예시 Bubble 표현
GuideHost's is_busy (your yes/no custom state) - 앱이 바쁘거나 이 작업을 사용할 수 없을 때 요소를 비활성화합니다.
ui_text_jsontext · 기본값: ""- 예시 값
{} - 예시 Bubble 표현
App Settings' player_labels_json (supported keys only) - 지원되는 버튼 레이블이 포함된 선택적 JSON. 비워 두면 내장 텍스트를 사용합니다.
languagetext · 기본값: "auto"- 예시 값
uk - 예시 Bubble 표현
Current User's preferred_language - language=auto로 설정하면 기기 또는 브라우저의 언어가 지원되는 경우 해당 언어를 따릅니다. 특정 언어를 직접 선택하려면 지원되는 언어 코드를 입력하세요.
액션 및 입력값 · 8
Play
동작 매개변수 없음
Pause
동작 매개변수 없음
Toggle
동작 매개변수 없음
Stop
동작 매개변수 없음
Seek
secondsnumber · 기본값: —- 예시 값
12 - 예시 Bubble 표현
Selected Comment's seconds - 현재 비즈니스 레코드의 값을 사용하고, 아래 제한과 비교해 검증하십시오.
Set speed
ratenumber · 기본값: —- 예시 값
1.5 - 예시 Bubble 표현
Speed Dropdown's value - 현재 비즈니스 레코드의 값을 사용하고, 아래 제한과 비교해 검증하십시오.
Set volume
volumenumber · 기본값: —- 예시 값
0.8 - 예시 Bubble 표현
Volume Slider's value - 현재 비즈니스 레코드의 값을 사용하고, 아래 제한과 비교해 검증하십시오.
Reload source
동작 매개변수 없음
상태 및 이벤트
상태
player_status · text이 작업의 현재 결과입니다. 성공을 저장하기 전에 일치하는 완료 이벤트를 사용하십시오.
is_playing · yes_no선택된 항목의 현재 값입니다. 관련 이벤트 후에 읽으십시오.
is_loaded · yes_no선택된 항목의 현재 값입니다. 관련 이벤트 후에 읽으십시오.
is_buffering · yes_no선택된 항목의 현재 값입니다. 관련 이벤트 후에 읽으십시오.
current_time · number선택된 항목의 현재 값입니다. 관련 이벤트 후에 읽으십시오.
duration · number선택된 항목의 현재 값입니다. 관련 이벤트 후에 읽으십시오.
progress · number선택된 항목의 현재 값입니다. 관련 이벤트 후에 읽으십시오.
playback_rate · number선택된 항목의 현재 값입니다. 관련 이벤트 후에 읽으십시오.
volume · number선택된 항목의 현재 값입니다. 관련 이벤트 후에 읽으십시오.
is_looping · yes_no선택된 항목의 현재 값입니다. 관련 이벤트 후에 읽으십시오.
waveform_available · yes_no선택된 항목의 현재 값입니다. 관련 이벤트 후에 읽으십시오.
waveform_status · text이 작업의 현재 결과입니다. 성공을 저장하기 전에 일치하는 완료 이벤트를 사용하십시오.
error_code · text마지막 작업에 대한 오류 정보입니다. 도움이 되는 메시지를 표시하고 관련 재시도를 제공하십시오.
이벤트
ready이 이벤트가 발생하면 동일한 요소에서 관련 상태를 읽습니다.
playback_started이 이벤트가 발생하면 동일한 요소에서 관련 상태를 읽습니다.
playback_paused이 이벤트가 발생하면 동일한 요소에서 관련 상태를 읽습니다.
playback_ended이 이벤트가 발생하면 동일한 요소에서 관련 상태를 읽습니다.
seek_completed이 이벤트가 발생하면 동일한 요소에서 관련 상태를 읽습니다.
rate_changed이 이벤트가 발생하면 동일한 요소에서 관련 상태를 읽습니다.
player_error이 이벤트가 발생하면 동일한 요소에서 관련 상태를 읽습니다.
개발자가 묻는 질문
파형을 생성합니까?
아니요. 해당 소스에 실제 정규화된 피크를 제공하십시오; 일반 진행은 피크 없이도 작동합니다.
구독은 어떻게 작동합니까?
For Audio Player, Video Player, Photo Editor, Audio Recorder, Files Kit and Haptics: free Bubble installation, a 7-day trial with a card, then US$1.50 per month per plugin and app project. Development and production are included, with no operation cap. File-size and feature limits still apply. Review billing and cancellation before confirming. Other plugins remain unavailable for purchase.
관련 가이드
도움을 받으려면 사용 중인 플러그인과 기기, 시도한 작업 및 발생한 상황을 알려 주세요. 개인 데이터가 없는 예시를 사용하십시오. 키나 개인 파일을 절대 공유하지 마세요.