[{"data":1,"prerenderedAt":206},["ShallowReactive",2],{"journal-all":3,"journal-post-odin-audio-context-dlya-vseh-zvukov":202},[4,14,23,32,41,50,59,68,77,86,95,104,113,122,131,140,149,158,167,175,184,193],{"id":5,"documentId":6,"title":7,"slug":8,"author":9,"displayDate":10,"publishedAt":11,"tags":12,"excerpt":13},128,"ejmfhc9x77pq7i6lk8uri7vz","Хорошие платформеры прощают маленькие ошибки","horoshie-platformery-proshhayut-malenkie-oshibki-igroka","Maxim","2026-10-08","2026-10-12T14:22:54.799Z",[],"Игрок нажал кнопку прыжка у самого края платформы, а персонаж вместо прыжка падает вниз. Или нажал прыжок чуть раньше приземления, и прыжок не…",{"id":15,"documentId":16,"title":17,"slug":18,"author":9,"displayDate":19,"publishedAt":20,"tags":21,"excerpt":22},151,"cpt6fex3mcb2pk2rwxrqlvl0","Что может локальный coding-agent на 16 GB VRAM","chto-mozhet-lokalnyj-coding-agent-na-16-gb-vram-1","2026-10-03","2026-10-22T07:06:46.248Z",[],"Обычно в работе с кодом я использую frontier-модели. Для разработки у меня достаточно мощный ПК, но специально под запуск локальных моделей я его не…",{"id":24,"documentId":25,"title":26,"slug":27,"author":9,"displayDate":28,"publishedAt":29,"tags":30,"excerpt":31},132,"pg9d6k0p2ggrjlpwnp0vmfhu","Публичный контракт вместо внутренних формул в typographics 5","publichnyj-kontrakt-vmesto-vnutrennih-formul-v-typographics-5","2026-09-03","2026-10-20T09:34:40.187Z",[],"Выпустил typographics@5.0.0. Изменение в самом CSS небольшое: блоки кода теперь по умолчанию используют ту же плавную базу, что и основной текст…",{"id":33,"documentId":34,"title":35,"slug":36,"author":9,"displayDate":37,"publishedAt":38,"tags":39,"excerpt":40},154,"bfbbuk4w3a8878alj8u8tjk7","Получить готовое решение и иметь основания ему доверять — разные вещи","poluchit-gotovoe-reshenie-i-imet-osnovaniya-emu-doveryat-raznye-veshhi","2026-08-22","2026-11-07T12:53:47.007Z",[],"Допустим, нужен поиск по каталогу. Поле ввода, запрос к серверу, список результатов. Поручаем это нейросети, получаем компонент, запускаем. Вводим…",{"id":42,"documentId":43,"title":44,"slug":45,"author":9,"displayDate":46,"publishedAt":47,"tags":48,"excerpt":49},133,"rrs7fbiul9xgn1lqvzvfkv40","Кэш не должен ломать загрузку спрайта","kesh-ne-dolzhen-lomat-zagruzku-sprajta","2026-08-11","2026-10-20T09:35:09.405Z",[],"В iconly 5.0.0 почти не добавил новых возможностей. Разобрал поведение библиотеки в нескольких ситуациях: хранилище недоступно, в кэше лежит плохой…",{"id":51,"documentId":52,"title":53,"slug":54,"author":9,"displayDate":55,"publishedAt":56,"tags":57,"excerpt":58},134,"v415k9na7rfuvuwadzaux2fq","playbackRate не вывозит","playback-rate-ne-vyvozit","2026-08-08","2026-10-20T09:35:39.760Z",[],"В mode=\"scroll\" лента должна ускоряться вместе со страницей и сохранять инерцию, когда прокрутка уже остановилась. После перехода на Web Animations…",{"id":60,"documentId":61,"title":62,"slug":63,"author":9,"displayDate":64,"publishedAt":65,"tags":66,"excerpt":67},131,"ashjhdkt56ram23r40w9vx7e","Два пути к SVG-спрайту в Iconly","dva-puti-k-svg-sprajtu-v-iconly","2026-07-11","2026-10-20T09:27:58.489Z",[],"В 3.0 у iconly появился довольно понятный контракт загрузки: при вызове init() загрузчик проверяет кэш, при необходимости получает внешний SVG-файл и…",{"id":69,"documentId":70,"title":71,"slug":72,"author":9,"displayDate":73,"publishedAt":74,"tags":75,"excerpt":76},135,"jesxp2we692xubc1lvx26tvm","Полируем clicktone","poliruem-clicktone","2026-07-03","2026-10-20T09:37:04.432Z",[],"После изменений в Web Audio поведение clicktone меня устраивает гораздо больше, чем инфраструктура вокруг пакета. Здесь есть неприятный класс ошибок…",{"id":78,"documentId":79,"title":80,"slug":81,"author":9,"displayDate":82,"publishedAt":83,"tags":84,"excerpt":85},136,"zz71n3thhwzglwwguq7j23sf","Vue поверх DOM-контроллера, а не вместо него","vue-poverh-dom-kontrollera-a-ne-vmesto-nego","2026-06-08","2026-10-20T09:37:48.997Z",[],"После 2.0.0 DOM API DialogLite позволяет передать готовый элемент или селектор, настроить закрытие, фокус и прокрутку, а затем явно уничтожить…",{"id":87,"documentId":88,"title":89,"slug":90,"author":9,"displayDate":91,"publishedAt":92,"tags":93,"excerpt":94},137,"gnxwj8ybwrbrexf3hhmg3cwj","Один AudioContext для всех звуков","odin-audio-context-dlya-vseh-zvukov","2026-06-03","2026-10-20T09:38:16.966Z",[],"В игре HopperGame звук перестал быть разовым эффектом, который можно включить и забыть. Один звук должен идти циклически, пока персонаж находится в…",{"id":96,"documentId":97,"title":98,"slug":99,"author":9,"displayDate":100,"publishedAt":101,"tags":102,"excerpt":103},149,"tb0zyd0dkyux359m1ekxjfqk","Стенограмма YouTube-видео локально на Windows через yt-dlp и Whisper от OpenAI","stenogramma-you-tube-video-lokalno-na-windows-cherez-yt-dlp-i-whisper-ot-open-ai","2026-03-17","2026-10-21T12:32:22.911Z",[],"Понадобилось получить обычный текст из YouTube-видео. Встроенная стенограмма есть не у каждого ролика, поэтому решил сделать всё локально: скачать…",{"id":105,"documentId":106,"title":107,"slug":108,"author":9,"displayDate":109,"publishedAt":110,"tags":111,"excerpt":112},138,"kcybzkzc77id357qven9oau2","Делаем API Iconly предсказуемым","delaem-api-iconly-predskazuemym","2026-01-25","2026-10-20T09:39:22.402Z",[],"В 2.0 в основном приводил в порядок внутреннее устройство iconly, сохраняя прежний способ использования. В 3.0 занялся публичным API. Я хотел, чтобы…",{"id":114,"documentId":115,"title":116,"slug":117,"author":9,"displayDate":118,"publishedAt":119,"tags":120,"excerpt":121},139,"x43svzw5tuasmmygpugo9ijk","Жёсткий DOM-контракт начал мешать","zhyostkij-dom-kontrakt-nachal-meshat","2025-12-16","2026-10-20T09:40:16.527Z",[],"В версии 1.5.1 у DialogLite был удобный, но довольно жёсткий договор с разметкой. Контроллер искал первый .dialog-lite, знал про #main-content…",{"id":123,"documentId":124,"title":125,"slug":126,"author":9,"displayDate":127,"publishedAt":128,"tags":129,"excerpt":130},140,"cvonqqvil2tn4fmgaiabss76","Две плавные шкалы вместо корня 10px","dve-plavnye-shkaly-vmesto-kornya-10px","2025-11-04","2026-10-20T09:41:13.937Z",[],"Выпустил typographics@3.0.0. Перед стабильным релизом обкатал новую мажорную версию в реальных проектах. Главное изменение оказалось не в новой…",{"id":132,"documentId":133,"title":134,"slug":135,"author":9,"displayDate":136,"publishedAt":137,"tags":138,"excerpt":139},141,"pvwfuo4kzfsvxwf7rz8tccbj","Вертикальный ритм на lh в typographics","vertikalnyj-ritm-na-lh-v-typographics","2025-09-20","2026-10-20T09:42:09.920Z",[],"Выпустил typographics@2.4.7. За последние две недели пакет заметно разросся вокруг довольно простой проблемы: на реальной странице одной шкалы…",{"id":141,"documentId":142,"title":143,"slug":144,"author":9,"displayDate":145,"publishedAt":146,"tags":147,"excerpt":148},142,"rn9rvxezqx4f3ivdrc6voh0s","Один play() для звука в мини-играх","odin-play-dlya-zvuka-v-mini-igrah","2025-04-17","2026-10-20T09:42:53.018Z",[],"В небольших промо-играх звук обычно нужен как отклик на действие пользователя, например нажатие кнопки. За таким эффектом быстро появляется…",{"id":150,"documentId":151,"title":152,"slug":153,"author":9,"displayDate":154,"publishedAt":155,"tags":156,"excerpt":157},143,"t5o8wrsruzuu542084uuz63y","Дорабатываю Iconly изнутри","dorabatyvayu-iconly-iznutri","2025-03-10","2026-10-20T09:43:35.331Z",[],"В 2.0.0 способ использования Iconly почти не изменился. Я пересмотрел внутреннюю реализацию: поиск контейнера, вставку SVG в DOM, обработку ошибок и…",{"id":159,"documentId":160,"title":161,"slug":162,"author":9,"displayDate":163,"publishedAt":164,"tags":165,"excerpt":166},144,"r0jxt6a2huml847j89tiyxrk","Расстаёмся с Custom Element","custom-element-uhodit-type-script-prihodit","2025-03-09","2026-10-20T09:44:47.700Z",[],"Custom Element давал marquee-content готовые методы жизненного цикла. Проблема появилась при интеграции с фреймворком: одним DOM-узлом одновременно…",{"id":168,"documentId":169,"title":170,"slug":171,"author":9,"displayDate":163,"publishedAt":172,"tags":173,"excerpt":174},145,"tkj2cgfjisq0rr061p90eusp","Один контроллер вместо диалогов под каждый проект","odin-kontroller-vmesto-dialogov-pod-kazhdyj-proekt","2026-10-20T09:45:24.409Z",[],"В разных проектах я снова и снова делал примерно одно и то же: находил контейнер диалога, открывал его, закрывал по кнопке или фону, переключал…",{"id":176,"documentId":177,"title":178,"slug":179,"author":9,"displayDate":180,"publishedAt":181,"tags":182,"excerpt":183},146,"ttv07xomzxiijk85sdob4rlx","SVG-спрайт в localStorage","svg-sprajt-v-local-storage","2024-06-02","2026-10-20T09:45:52.655Z",[],"Кэшировать SVG-спрайт в браузере сначала кажется задачей на несколько строк. Получил файл, положил строку в localStorage, при следующем запуске…",{"id":185,"documentId":186,"title":187,"slug":188,"author":9,"displayDate":189,"publishedAt":190,"tags":191,"excerpt":192},147,"ewuzaa0hw5kfc6gzqph0k67u","Бесконечная анимация, конечный жизненный цикл","beskonechnaya-animacziya-konechnyj-zhiznennyj-czikl","2023-10-31","2026-10-20T09:46:16.781Z",[],"Бесконечная анимация — нормальное поведение для бегущей строки. Бесконечные обработчики и наблюдатели — нет. При ручных проверках заметил, что…",{"id":194,"documentId":195,"title":196,"slug":197,"author":9,"displayDate":198,"publishedAt":199,"tags":200,"excerpt":201},148,"n9v8botqj54tx61u0jahrprs","Бегущая строка за четыре дня","begushhaya-stroka-za-chetyre-dnya","2023-03-24","2026-10-20T09:47:13.002Z",[],"Бегущая строка выглядит почти оскорбительно простой задачей — положить элементы в ряд, сдвигать их влево или вправо и повторять всё сначала. Примерно…",{"id":87,"documentId":88,"title":89,"content":203,"slug":90,"author":9,"displayDate":91,"publishedAt":92,"tags":204,"html":205},"В игре HopperGame звук перестал быть разовым эффектом, который можно включить и забыть.\n\nОдин звук должен идти циклически, пока персонаж находится в определённом состоянии. Другой при повторном `play()` можно наложить поверх предыдущего. Третий нужно прервать или вообще не запускать повторно, пока он ещё звучит.\n\nПосле возврата в Safari на iOS одного `AudioContext.state` оказалось недостаточно: контекст может сообщать `running`, хотя реального звука уже нет.\n\nУ каждого `ClickTone` был свой `AudioContext`, и разбирать все эти случаи отдельно для каждого экземпляра стало неудобно.\n\n## Общий контекст и кеш\n\nДо `2.0.0` у каждого звука был свой контекст и свой кеш декодированных файлов. Для простого `play()` это нормально, но разблокировка и восстановление после возврата на страницу относятся уже не к конкретному эффекту. Это состояние всей аудиосистемы страницы.\n\nПоэтому появился `SharedAudioEngine`:\n\n```ts\nexport class SharedAudioEngine {\n  #ctx: AudioContext | null = null;\n  #decodeCache = new Map\u003Cstring, Promise\u003CAudioBuffer>>();\n\n  \u002F\u002F ...\n}\n\nexport const engine = new SharedAudioEngine();\n```\n\nЭкземпляры ClickTone теперь обращаются к общему движку:\n\n```ts\nengine.prime();\n\nconst buffer = await engine.decode(url);\nconst ctx = engine.context();\n```\n\nКеш тоже стал общим. Если два звука используют один URL, загружать и декодировать один файл дважды смысла нет.\n\nПри этом настройки конкретного эффекта остались в `ClickTone`: `volume`, `muted`, `throttle`, `pitchVariation` и собственный `GainNode`. Движок занимается только тем, что действительно должно жить на уровне страницы.\n\n## Одна разблокировка вместо обработчиков на каждом звуке\n\nДвижок устанавливает общий набор обработчиков пользовательских жестов и изменений состояния страницы:\n\n```ts\nprime(): void {\n  if (this.#primed || !hasDOM) return;\n\n  this.#primed = true;\n  this.#installGestureUnlock();\n  this.#installVisibilityHandler();\n}\n```\n\nПервый подходящий жест вызывает `unlock()`. Если контекст приостановлен, движок вызывает `resume()`. После успешной разблокировки дополнительно запускается почти бесшумный односэмпловый буфер, чтобы помочь Web Audio окончательно проснуться.\n\nЗа разблокировку аудио на странице теперь отвечает общий движок. Каждому звуку больше не нужны свои обработчики касаний и собственное представление о том, готов ли Web Audio.\n\n## Если AudioContext только выглядит рабочим\n\nПоведение проверял в разных браузерах на Windows, iOS и Android. После `2.0.0` нашёлся неприятный кейс Safari\u002FiOS: после ухода из браузера и возврата обратно `AudioContext` может остаться в `state === 'running'`, но перестать реально воспроизводить звук.\n\nПоэтому в `2.1.0` проверяю ещё и `currentTime`. После возврата на страницу движок запоминает значение, ждёт `200ms` и смотрит, продвинулось ли аудиовремя:\n\n```ts\nconst start = ctx.currentTime;\n\nawait new Promise((resolve) =>\n  setTimeout(resolve, SharedAudioEngine.#ZOMBIE_PROBE_MS),\n);\n\nif (ctx.state === 'running' && ctx.currentTime \u003C= start) {\n  this.#needsHardRecovery = true;\n}\n```\n\nЕсли состояние говорит `running`, а `currentTime` стоит на месте, обычного `resume()` уже недостаточно.\n\nСразу пересоздавать контекст на `visibilitychange` я не стал. Полное восстановление откладывается до следующего вызова `unlock()`:\n\n```ts\nif (this.#needsHardRecovery) this.#recreate();\n```\n\n`unlock()` вызывают обработчики пользовательских жестов и сам `play()`. Если запуск связан с жестом, браузер с большей вероятностью разрешит снова поднять аудио. Наличие жеста библиотека не проверяет, поэтому программный вызов тоже может запустить восстановление.\n\n## После пересоздания нужно восстановить аудиограф\n\n`new AudioContext()` сам по себе не решает проблему. `GainNode` и активные `AudioBufferSourceNode` были созданы в старом контексте и вместе с ним становятся бесполезны.\n\nПоэтому ClickTone подписывается на пересоздание контекста:\n\n```ts\nthis.#recreateUnsubscribe = engine.onRecreate(() =>\n  this.#restartActiveLoops(),\n);\n```\n\n`GainNode` пересоздаётся, если относится уже не к текущему контексту. Активные циклические воспроизведения собираются по URL и запускаются заново с новым контекстом.\n\nИменно на этом месте стало понятно, что циклическое воспроизведение нельзя считать тем же коротким звуком, только с `source.loop = true`. Если звук живёт дольше одного вызова, библиотеке приходится помнить о нём.\n\n## Хранить активное воспроизведение\n\nВ `2.1.0` экземпляр начал отслеживать созданные источники звука:\n\n```ts\ntype ActivePlayback = {\n  source: AudioBufferSourceNode;\n  url: string;\n  loop: boolean;\n  stopped: boolean;\n};\n\n#activePlaybacks = new Set\u003CActivePlayback>();\n```\n\nПри запуске источник добавляется в набор:\n\n```ts\nsource.buffer = buffer;\nsource.loop = loop;\n\nconst playback: ActivePlayback = {\n  source,\n  url,\n  loop,\n  stopped: false,\n};\n\nthis.#activePlaybacks.add(playback);\nsource.start(0);\n```\n\nПосле этого `stop()` может остановить активное воспроизведение:\n\n```ts\nstop(): void {\n  this.#stopActivePlaybacks(true);\n}\n```\n\nДля HopperGame это как раз тот API, которого не хватало:\n\n```ts\nconst flying = new ClickTone({\n  src: '.\u002Fflying.mp3',\n  loop: true,\n  preload: true,\n});\n\nawait flying.play();\n\n\u002F\u002F состояние закончилось\nflying.stop();\n```\n\nДлительность эффекта здесь задаёт уже состояние игры, а не длина аудиофайла.\n\n## Что означает повторный play()\n\nДля озвучки короткого клика наложение обычно нормально. У игрового эффекта повторный вызов может означать совсем другое, поэтому в `2.1.0` это стало явной настройкой:\n\n```ts\ntype ReplayBehavior =\n  | 'overlap'\n  | 'interrupt'\n  | 'ignore-if-playing'\n  | 'restart';\n```\n\n`overlap` оставляет прежнее поведение и создаёт новое воспроизведение. `interrupt` прерывает активное воспроизведение и запускает новое. `ignore-if-playing` ничего не делает, если звук уже идёт. `restart` обязательно начинает воспроизведение заново.\n\nДля `restart` обычный `throttle` пришлось обходить:\n\n```ts\nif (\n  !skipThrottle &&\n  replay !== 'restart' &&\n  now - this.#lastPlay \u003C this.#throttle\n) {\n  return;\n}\n```\n\nИначе явная команда перезапустить звук могла бы потеряться из-за ограничения, которое решает совсем другую задачу.\n\nПоведение при повторном `play()` можно задать на экземпляре:\n\n```ts\nconst terminal = new ClickTone({\n  src: '.\u002Fterminal.mp3',\n  replay: 'interrupt',\n});\n\nawait terminal.play();\n```\n\n## Что возвращает play() для loop\n\nДля обычного звука `play()` возвращает `Promise`, который завершается после `source.onended`. У циклического воспроизведения естественного конца может не быть вообще.\n\nПоэтому циклическое воспроизведение считается запущенным сразу после `source.start(0)`, а ожидание `onended` остаётся только для обычного эффекта:\n\n```ts\nsource.start(0);\nthis.#emit('play');\n\nif (!loop) await ended;\n```\n\nЗаодно `stop` получил отдельное событие. Естественное завершение даёт `end`, явное прерывание — `stop`.\n\nВ результате короткий UI-звук по-прежнему запускается обычным `play()`. Но если эффект связан с состоянием игры, его теперь можно зациклить, остановить и заранее определить, что должен означать повторный вызов. А восстановление Web Audio больше не размазано по экземплярам и живёт рядом с общим `AudioContext`.\n\nОписанные примеры относятся к браузерному ESM API. У опубликованного `2.1.0` остаются проблемы с подключением CommonJS и типов: файл `index.cjs.js` содержит CommonJS-код внутри пакета с `type: module`, а `index.d.ts` ссылается на отсутствующий `main.d.ts`.\n\n## Материалы\n\n- MDN, Web Audio best practices: \u003Chttps:\u002F\u002Fdeveloper.mozilla.org\u002Fen-US\u002Fdocs\u002FWeb\u002FAPI\u002FWeb_Audio_API\u002FBest_practices>\n- MDN, `AudioContext.resume()`: \u003Chttps:\u002F\u002Fdeveloper.mozilla.org\u002Fen-US\u002Fdocs\u002FWeb\u002FAPI\u002FAudioContext\u002Fresume>\n- MDN, `BaseAudioContext.currentTime`: \u003Chttps:\u002F\u002Fdeveloper.mozilla.org\u002Fen-US\u002Fdocs\u002FWeb\u002FAPI\u002FBaseAudioContext\u002FcurrentTime>\n- WebKit Bug 217606: \u003Chttps:\u002F\u002Fbugs.webkit.org\u002Fshow_bug.cgi?id=217606>\n- WebKit Bug 263627: \u003Chttps:\u002F\u002Fbugs.webkit.org\u002Fshow_bug.cgi?id=263627>\n- WebKit Bug 276687: \u003Chttps:\u002F\u002Fbugs.webkit.org\u002Fshow_bug.cgi?id=276687>",[],"\u003Cp class=\"body-large\">В игре HopperGame звук перестал быть разовым эффектом, который можно включить и забыть.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Один звук должен идти циклически, пока персонаж находится в определённом состоянии. Другой при повторном \u003Ccode>play()\u003C\u002Fcode> можно наложить поверх предыдущего. Третий нужно прервать или вообще не запускать повторно, пока он ещё звучит.\u003C\u002Fp>\n\u003Cp class=\"body-large\">После возврата в Safari на iOS одного \u003Ccode>AudioContext.state\u003C\u002Fcode> оказалось недостаточно: контекст может сообщать \u003Ccode>running\u003C\u002Fcode>, хотя реального звука уже нет.\u003C\u002Fp>\n\u003Cp class=\"body-large\">У каждого \u003Ccode>ClickTone\u003C\u002Fcode> был свой \u003Ccode>AudioContext\u003C\u002Fcode>, и разбирать все эти случаи отдельно для каждого экземпляра стало неудобно.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Общий контекст и кеш\u003C\u002Fh2>\n\u003Cp class=\"body-large\">До \u003Ccode>2.0.0\u003C\u002Fcode> у каждого звука был свой контекст и свой кеш декодированных файлов. Для простого \u003Ccode>play()\u003C\u002Fcode> это нормально, но разблокировка и восстановление после возврата на страницу относятся уже не к конкретному эффекту. Это состояние всей аудиосистемы страницы.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Поэтому появился \u003Ccode>SharedAudioEngine\u003C\u002Fcode>:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">export\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> class\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> SharedAudioEngine\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFAB70\">  #ctx\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> AudioContext\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> |\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> null\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> null\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFAB70\">  #decodeCache\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> new\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> Map\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">&#x3C;\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\">string\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">, \u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">Promise\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">&#x3C;\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">AudioBuffer\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">>>();\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#6A737D\">  \u002F\u002F ...\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">export\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> const\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> engine\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> new\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> SharedAudioEngine\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">();\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Экземпляры ClickTone теперь обращаются к общему движку:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">engine.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">prime\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">();\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">const\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> buffer\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> await\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> engine.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">decode\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(url);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">const\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> ctx\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> engine.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">context\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">();\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Кеш тоже стал общим. Если два звука используют один URL, загружать и декодировать один файл дважды смысла нет.\u003C\u002Fp>\n\u003Cp class=\"body-large\">При этом настройки конкретного эффекта остались в \u003Ccode>ClickTone\u003C\u002Fcode>: \u003Ccode>volume\u003C\u002Fcode>, \u003Ccode>muted\u003C\u002Fcode>, \u003Ccode>throttle\u003C\u002Fcode>, \u003Ccode>pitchVariation\u003C\u002Fcode> и собственный \u003Ccode>GainNode\u003C\u002Fcode>. Движок занимается только тем, что действительно должно жить на уровне страницы.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Одна разблокировка вместо обработчиков на каждом звуке\u003C\u002Fh2>\n\u003Cp class=\"body-large\">Движок устанавливает общий набор обработчиков пользовательских жестов и изменений состояния страницы:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">prime\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(): \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">void\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  if\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> (\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\">this\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">.#primed \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">||\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> !\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">hasDOM) \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">return\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#79B8FF\">  this\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">.#primed \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">=\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> true\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#79B8FF\">  this\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">#installGestureUnlock\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">();\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#79B8FF\">  this\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">#installVisibilityHandler\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">();\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Первый подходящий жест вызывает \u003Ccode>unlock()\u003C\u002Fcode>. Если контекст приостановлен, движок вызывает \u003Ccode>resume()\u003C\u002Fcode>. После успешной разблокировки дополнительно запускается почти бесшумный односэмпловый буфер, чтобы помочь Web Audio окончательно проснуться.\u003C\u002Fp>\n\u003Cp class=\"body-large\">За разблокировку аудио на странице теперь отвечает общий движок. Каждому звуку больше не нужны свои обработчики касаний и собственное представление о том, готов ли Web Audio.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Если AudioContext только выглядит рабочим\u003C\u002Fh2>\n\u003Cp class=\"body-large\">Поведение проверял в разных браузерах на Windows, iOS и Android. После \u003Ccode>2.0.0\u003C\u002Fcode> нашёлся неприятный кейс Safari\u002FiOS: после ухода из браузера и возврата обратно \u003Ccode>AudioContext\u003C\u002Fcode> может остаться в \u003Ccode>state === 'running'\u003C\u002Fcode>, но перестать реально воспроизводить звук.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Поэтому в \u003Ccode>2.1.0\u003C\u002Fcode> проверяю ещё и \u003Ccode>currentTime\u003C\u002Fcode>. После возврата на страницу движок запоминает значение, ждёт \u003Ccode>200ms\u003C\u002Fcode> и смотрит, продвинулось ли аудиовремя:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">const\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> start\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> ctx.currentTime;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">await\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> new\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> Promise\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">((\u003C\u002Fspan>\u003Cspan style=\"color:#FFAB70\">resolve\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">) \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">=>\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">  setTimeout\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(resolve, SharedAudioEngine.\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\">#ZOMBIE_PROBE_MS\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">),\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">if\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> (ctx.state \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">===\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\"> 'running'\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> &#x26;&#x26;\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> ctx.currentTime \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">&#x3C;=\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> start) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#79B8FF\">  this\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">.#needsHardRecovery \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">=\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> true\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Если состояние говорит \u003Ccode>running\u003C\u002Fcode>, а \u003Ccode>currentTime\u003C\u002Fcode> стоит на месте, обычного \u003Ccode>resume()\u003C\u002Fcode> уже недостаточно.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Сразу пересоздавать контекст на \u003Ccode>visibilitychange\u003C\u002Fcode> я не стал. Полное восстановление откладывается до следующего вызова \u003Ccode>unlock()\u003C\u002Fcode>:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">if\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> (\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\">this\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">.#needsHardRecovery) \u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\">this\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">#recreate\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">();\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">\u003Ccode>unlock()\u003C\u002Fcode> вызывают обработчики пользовательских жестов и сам \u003Ccode>play()\u003C\u002Fcode>. Если запуск связан с жестом, браузер с большей вероятностью разрешит снова поднять аудио. Наличие жеста библиотека не проверяет, поэтому программный вызов тоже может запустить восстановление.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">После пересоздания нужно восстановить аудиограф\u003C\u002Fh2>\n\u003Cp class=\"body-large\">\u003Ccode>new AudioContext()\u003C\u002Fcode> сам по себе не решает проблему. \u003Ccode>GainNode\u003C\u002Fcode> и активные \u003Ccode>AudioBufferSourceNode\u003C\u002Fcode> были созданы в старом контексте и вместе с ним становятся бесполезны.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Поэтому ClickTone подписывается на пересоздание контекста:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#79B8FF\">this\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">.#recreateUnsubscribe \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">=\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> engine.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">onRecreate\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(() \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">=>\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#79B8FF\">  this\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">#restartActiveLoops\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(),\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">\u003Ccode>GainNode\u003C\u002Fcode> пересоздаётся, если относится уже не к текущему контексту. Активные циклические воспроизведения собираются по URL и запускаются заново с новым контекстом.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Именно на этом месте стало понятно, что циклическое воспроизведение нельзя считать тем же коротким звуком, только с \u003Ccode>source.loop = true\u003C\u002Fcode>. Если звук живёт дольше одного вызова, библиотеке приходится помнить о нём.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Хранить активное воспроизведение\u003C\u002Fh2>\n\u003Cp class=\"body-large\">В \u003Ccode>2.1.0\u003C\u002Fcode> экземпляр начал отслеживать созданные источники звука:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">type\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> ActivePlayback\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFAB70\">  source\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> AudioBufferSourceNode\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFAB70\">  url\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> string\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFAB70\">  loop\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> boolean\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#FFAB70\">  stopped\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> boolean\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">};\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">#activePlaybacks \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">=\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> new\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> Set\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">&#x3C;\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">ActivePlayback\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">>();\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">При запуске источник добавляется в набор:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">source.buffer \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">=\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> buffer;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">source.loop \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">=\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> loop;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">const\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> playback\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">:\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> ActivePlayback\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  source,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  url,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  loop,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  stopped: \u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\">false\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">};\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#79B8FF\">this\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">.#activePlaybacks.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">add\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(playback);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">source.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">start\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\">0\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">После этого \u003Ccode>stop()\u003C\u002Fcode> может остановить активное воспроизведение:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#B392F0\">stop\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(): \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">void\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#79B8FF\">  this\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">#stopActivePlaybacks\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\">true\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Для HopperGame это как раз тот API, которого не хватало:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">const\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> flying\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> new\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> ClickTone\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">({\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  src: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">'.\u002Fflying.mp3'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  loop: \u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\">true\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  preload: \u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\">true\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">});\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">await\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> flying.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">play\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">();\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#6A737D\">\u002F\u002F состояние закончилось\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">flying.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">stop\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">();\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Длительность эффекта здесь задаёт уже состояние игры, а не длина аудиофайла.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Что означает повторный play()\u003C\u002Fh2>\n\u003Cp class=\"body-large\">Для озвучки короткого клика наложение обычно нормально. У игрового эффекта повторный вызов может означать совсем другое, поэтому в \u003Ccode>2.1.0\u003C\u002Fcode> это стало явной настройкой:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">type\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> ReplayBehavior\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  |\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\"> 'overlap'\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  |\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\"> 'interrupt'\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  |\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\"> 'ignore-if-playing'\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  |\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\"> 'restart'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">\u003Ccode>overlap\u003C\u002Fcode> оставляет прежнее поведение и создаёт новое воспроизведение. \u003Ccode>interrupt\u003C\u002Fcode> прерывает активное воспроизведение и запускает новое. \u003Ccode>ignore-if-playing\u003C\u002Fcode> ничего не делает, если звук уже идёт. \u003Ccode>restart\u003C\u002Fcode> обязательно начинает воспроизведение заново.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Для \u003Ccode>restart\u003C\u002Fcode> обычный \u003Ccode>throttle\u003C\u002Fcode> пришлось обходить:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">if\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> (\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  !\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">skipThrottle \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">&#x26;&#x26;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  replay \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">!==\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\"> 'restart'\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> &#x26;&#x26;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  now \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">-\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> this\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">.#lastPlay \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">&#x3C;\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> this\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">.#throttle\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">) {\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">  return\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">}\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Иначе явная команда перезапустить звук могла бы потеряться из-за ограничения, которое решает совсем другую задачу.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Поведение при повторном \u003Ccode>play()\u003C\u002Fcode> можно задать на экземпляре:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">const\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\"> terminal\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> =\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\"> new\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\"> ClickTone\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">({\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  src: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">'.\u002Fterminal.mp3'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">  replay: \u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">'interrupt'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">,\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">});\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">await\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> terminal.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">play\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">();\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Ch2 class=\"headline-medium\">Что возвращает play() для loop\u003C\u002Fh2>\n\u003Cp class=\"body-large\">Для обычного звука \u003Ccode>play()\u003C\u002Fcode> возвращает \u003Ccode>Promise\u003C\u002Fcode>, который завершается после \u003Ccode>source.onended\u003C\u002Fcode>. У циклического воспроизведения естественного конца может не быть вообще.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Поэтому циклическое воспроизведение считается запущенным сразу после \u003Ccode>source.start(0)\u003C\u002Fcode>, а ожидание \u003Ccode>onended\u003C\u002Fcode> остаётся только для обычного эффекта:\u003C\u002Fp>\n\u003Cpre class=\"shiki github-dark\" style=\"background-color:#24292e;color:#e1e4e8\" tabindex=\"0\">\u003Ccode>\u003Cspan class=\"line\">\u003Cspan style=\"color:#E1E4E8\">source.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">start\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(\u003C\u002Fspan>\u003Cspan style=\"color:#79B8FF\">0\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#79B8FF\">this\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">.\u003C\u002Fspan>\u003Cspan style=\"color:#B392F0\">#emit\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">(\u003C\u002Fspan>\u003Cspan style=\"color:#9ECBFF\">'play'\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">);\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003Cspan style=\"color:#F97583\">if\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> (\u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">!\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\">loop) \u003C\u002Fspan>\u003Cspan style=\"color:#F97583\">await\u003C\u002Fspan>\u003Cspan style=\"color:#E1E4E8\"> ended;\u003C\u002Fspan>\u003C\u002Fspan>\n\u003Cspan class=\"line\">\u003C\u002Fspan>\u003C\u002Fcode>\u003C\u002Fpre>\u003Cp class=\"body-large\">Заодно \u003Ccode>stop\u003C\u002Fcode> получил отдельное событие. Естественное завершение даёт \u003Ccode>end\u003C\u002Fcode>, явное прерывание — \u003Ccode>stop\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cp class=\"body-large\">В результате короткий UI-звук по-прежнему запускается обычным \u003Ccode>play()\u003C\u002Fcode>. Но если эффект связан с состоянием игры, его теперь можно зациклить, остановить и заранее определить, что должен означать повторный вызов. А восстановление Web Audio больше не размазано по экземплярам и живёт рядом с общим \u003Ccode>AudioContext\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Cp class=\"body-large\">Описанные примеры относятся к браузерному ESM API. У опубликованного \u003Ccode>2.1.0\u003C\u002Fcode> остаются проблемы с подключением CommonJS и типов: файл \u003Ccode>index.cjs.js\u003C\u002Fcode> содержит CommonJS-код внутри пакета с \u003Ccode>type: module\u003C\u002Fcode>, а \u003Ccode>index.d.ts\u003C\u002Fcode> ссылается на отсутствующий \u003Ccode>main.d.ts\u003C\u002Fcode>.\u003C\u002Fp>\n\u003Ch2 class=\"headline-medium\">Материалы\u003C\u002Fh2>\n\u003Cul class=\"list-large\">\n\u003Cli>MDN, Web Audio best practices: \u003Ca href=\"https:\u002F\u002Fdeveloper.mozilla.org\u002Fen-US\u002Fdocs\u002FWeb\u002FAPI\u002FWeb_Audio_API\u002FBest_practices\" data-cursor-style=\"dot\">https:\u002F\u002Fdeveloper.mozilla.org\u002Fen-US\u002Fdocs\u002FWeb\u002FAPI\u002FWeb_Audio_API\u002FBest_practices\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>MDN, \u003Ccode>AudioContext.resume()\u003C\u002Fcode>: \u003Ca href=\"https:\u002F\u002Fdeveloper.mozilla.org\u002Fen-US\u002Fdocs\u002FWeb\u002FAPI\u002FAudioContext\u002Fresume\" data-cursor-style=\"dot\">https:\u002F\u002Fdeveloper.mozilla.org\u002Fen-US\u002Fdocs\u002FWeb\u002FAPI\u002FAudioContext\u002Fresume\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>MDN, \u003Ccode>BaseAudioContext.currentTime\u003C\u002Fcode>: \u003Ca href=\"https:\u002F\u002Fdeveloper.mozilla.org\u002Fen-US\u002Fdocs\u002FWeb\u002FAPI\u002FBaseAudioContext\u002FcurrentTime\" data-cursor-style=\"dot\">https:\u002F\u002Fdeveloper.mozilla.org\u002Fen-US\u002Fdocs\u002FWeb\u002FAPI\u002FBaseAudioContext\u002FcurrentTime\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>WebKit Bug 217606: \u003Ca href=\"https:\u002F\u002Fbugs.webkit.org\u002Fshow_bug.cgi?id=217606\" data-cursor-style=\"dot\">https:\u002F\u002Fbugs.webkit.org\u002Fshow_bug.cgi?id=217606\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>WebKit Bug 263627: \u003Ca href=\"https:\u002F\u002Fbugs.webkit.org\u002Fshow_bug.cgi?id=263627\" data-cursor-style=\"dot\">https:\u002F\u002Fbugs.webkit.org\u002Fshow_bug.cgi?id=263627\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>WebKit Bug 276687: \u003Ca href=\"https:\u002F\u002Fbugs.webkit.org\u002Fshow_bug.cgi?id=276687\" data-cursor-style=\"dot\">https:\u002F\u002Fbugs.webkit.org\u002Fshow_bug.cgi?id=276687\u003C\u002Fa>\u003C\u002Fli>\n\u003C\u002Ful>\n",1795172791283]