홈페이지>프로그래밍 관련>기타 소스코드
다운로드

오디오링크

CSharp 및 HLSL로 작성되었으며 VRChat 및 ChilloutVR과 호환되는 Unity용 오디오 반응형 프리팹 저장소

AudioLink는 세계 내 오디오를 반응성이 높은 다양한 데이터 스트림으로 분석 및 처리하고 해당 데이터를 스크립트 및 셰이더에 노출하는 시스템입니다.

주파수별 오디오 진폭 데이터는 먼저 Unity의 GetOutputData를 사용하여 Udon으로 간략하게 읽혀집니다. 그런 다음 신호 처리를 위해 GPU로 전송되고 CustomRenderTexture로 버퍼링됩니다. 그런 다음 CustomRenderTexture가 전역적으로 브로드캐스트되며( _AudioTexture 라고 함) 이는 세계 내 및 모든 아바타의 셰이더에서 선택할 수 있습니다.

공개 예제 세계

자주 묻는 질문

셰이더 제작자를 위한 문서

2.0.0 - 2024년 9월 8일

새로운 기능

  • AudioLink 컨트롤러 동기화 방법을 조정하는 기능이 추가되었습니다. 모든 부분을 동기화하거나, 아무것도 동기화하지 않거나, 게인 및 전원 제어를 제외한 모든 것을 동기화할 수 있습니다. (기본)

  • 별도의 소스에서 왼쪽 및 오른쪽 채널을 공급하려는 경우 듀얼 모노 오디오 소스에 대한 지원이 추가되었습니다. (기본)

  • AudioLink - AudioReactiveBlendshapes를 사용하여 블렌드 셰이프를 구동하기 위한 유틸리티 스크립트를 추가했습니다. 사용할 SkinnedMeshRenderer가 있는 GameObject에 스크립트를 추가하기만 하면 됩니다. (기본)

  • WebGL 빌드 대상과 함께 AudioLink를 사용하기 위한 기본적인 지원이 추가되었습니다. (펀데일, 언덕)

변경 사항

  • AudioLink 아바타 프리팹의 기본 볼륨을 약간 낮췄습니다. (페마)

  • AudioLink 상태를 약간 동기화하여 발생하는 네트워크 트래픽을 줄입니다. (해피로봇33)

  • 동작이 변경되어 ThemeColorController.customThemeColors 더 이상 사용되지 않습니다. 대신 ThemeColorController.SetCustomThemeColors 및 ThemeColorController.GetCustomThemeColors 사용하세요. 이는 (사소한) 주요 변경 사항입니다.

버그수정

  • 컨트롤러의 색상 코드 테마 색상 토글이 제대로 동기화되지 않는 버그를 수정했습니다. (페마)

버전 0.2.8 이하에서 프로젝트를 업데이트하시나요? (...최초 설정인가요? 다음 섹션을 참조하세요)

  1. 프로젝트를 업그레이드하기 전에 백업을 만드세요 ! 최신 버전의 AudioLink는 많은 변화를 가져왔습니다. 후회하는 것보다 안전이 더 좋습니다.

  2. AudioLink를 제공하기 위해 어떤 AudioSource를 사용하고 있는지 기록해 두십시오. 이 참조는 업그레이드 중에 손실될 수 있습니다.

  3. 프로젝트에 VRChat Creator Companion(VCC)을 사용해 본 적이 없다면 아래 단계를 따르세요. 그렇지 않으면 4단계로 건너뜁니다.

    • VRChat Creator Companion을 다운로드하여 설치하고 엽니다.

    • "프로젝트" 탭의 "추가" 옵션을 사용하고 표시된 단계에 따라 프로젝트를 VCC에 추가하세요.

    • 프로젝트 탭을 열고 프로젝트를 선택한 후 "마이그레이션" 버튼을 누르고 표시된 단계를 따르세요.

  4. 프로젝트 탭을 열고 프로젝트를 선택하세요.

  5. 오른쪽에서 AudioLink 패키지를 찾아서 추가하세요. 표시되지 않으면 오른쪽 상단 드롭다운에서 "선별" 토글이 활성화되어 있는지 확인하세요.

  6. Unity를 열지 않은 상태 에서 파일 브라우저에서 프로젝트 Assets 폴더로 이동하여 "AudioLink" 폴더와 "AudioLink.meta" 파일을 삭제합니다.

  7. Unity에서 프로젝트를 엽니다.

  8. AudioLink 셰이더 업그레이드 프로그램에서 이전 셰이더를 업그레이드하라는 메시지가 표시될 수 있습니다. 프로젝트에서 사용자 정의 AudioLink 지원 셰이더를 사용하는 경우 그렇게 해야 합니다.

  9. AudioLink 예제 장면의 자산을 사용하는 경우 기본적으로 가져오지 않으므로 가져와야 합니다. 그렇게 하려면 편집기 상단 메뉴에서 "AudioLink -> Open AudioLink 예제 장면"을 사용하십시오.

  10. AudioReactiveObject 또는 AudioReactiveLight 구성 요소를 사용하는 경우 AudioLink "실험" 설정에서 "오디오 데이터"를 수동으로 다시 활성화해야 할 수도 있습니다. 이 기능은 이제 VRChat이 네이티브 비동기 리드백을 제공 할 때까지 실험적인 것으로 간주됩니다.

  11. 이전 버전의 AudioLink가 포함된 장면에서:

  • 장면에서 AudioLink 및 AudioLinkController 프리팹을 모두 삭제합니다.

  • Packages/com.llealloo.audiolink/Runtime 폴더에서 프리팹을 드래그하여 AudioLink 및 AudioLinkController를 장면에 다시 추가합니다.

  • AudioLink 검사기 패널에서 "모든 사운드 반응 개체를 이 AudioLink에 연결" 버튼을 클릭하세요.

  • 이전에 사용했던 AudioSource를 AudioLink 오디오 소스 매개변수로 드래그하세요.

    • 참고: 이전에 AudioLinkInput을 사용한 경우 계속해서 사용할 수 있지만 이제 0.2.5 이상에서는 AudioLink가 입력에 대해 훨씬 더 똑똑해졌습니다. AudioLink/오디오 소스 매개변수로 바로 드래그해 보세요!

아바타 프로젝트 업그레이드

  1. 파일 브라우저에서 "Assets/AudioLink" 폴더와 "AudioLink.meta" 파일을 삭제하세요.

  2. 아래에 설명된 아바타 프로젝트의 "최초 설정" 단계를 따르세요.

설치

VRC

아바타를 테스트하고 싶으신가요? "VRC 아바타 테스트용" 섹션을 참조하세요. 그렇지 않은 경우 설치 후 "VRC Worlds 및 기타 사용 사례" 섹션을 참조하세요.

VCC(윈도우 전용)

  1. VRChat Creator Companion(VCC)을 다운로드하여 설치하고 엽니다.

  2. VCC에 프로젝트를 추가하세요:

    • 새 프로젝트를 생성하려면 "프로젝트" 탭에서 "새로 만들기" 옵션을 사용하고 해당 단계를 따르세요.

    • 기존 프로젝트를 사용하려면 "프로젝트" 탭에서 "추가" 옵션을 사용하고 해당 단계를 따르세요.

  3. 프로젝트 탭을 열고 프로젝트를 선택하세요. 프로젝트에 VCC를 사용한 적이 없다면 "마이그레이트" 버튼을 사용하여 업그레이드하세요.

  4. 오른쪽에서 AudioLink 패키지를 찾아서 추가하세요. 표시되지 않으면 오른쪽 상단 드롭다운에서 "선별" 토글이 활성화되어 있는지 확인하세요.

  5. 이 시점에서 설치가 완료되었습니다. 프로젝트를 열려면 VCC에서 "프로젝트 열기" 버튼을 사용할 수 있습니다.

명령줄(Linux/macOs/Windows)

Linux 및 macOS에 설치하고 명령줄을 선호하는 Windows 사용자의 경우 vrc-get 사용하는 것이 좋습니다. 이는 vpm 이 오픈 소스이고 이 글을 쓰는 시점에 일부 시스템에서 작동하지 못하게 할 수 있는 해결되지 않은 버그가 있기 때문입니다.

vrc-get

  1. vrc-get 설치

  2. 콘솔을 열고 cd /path/to/your/project

  3. vrc-get i audiolink 실행하세요.

vpm

  1. vpm을 설치하고 설정 지침을 따르세요.

  2. vpm add package com.llealloo.audiolink -p /path/to/your/unity/project 실행하세요.

일반(CVR을 포함한 비 VRC)

  1. https://github.com/llealloo/vrc-udon-audio-link/releases에서 최신 UnityPackage AudioLink 릴리스를 다운로드하고 가져옵니다.

  2. "도구/AudioLink/장면에 AudioLink 프리팹 추가" 메뉴 항목을 사용하십시오. 그것은 즉시 작동해야합니다.

시작하기

설치 후 AudioLink를 사용하려면:

  1. 예제 장면을 보려면 편집기 상단 메뉴의 "AudioLink/Open AudioLink 예제 장면" 버튼을 사용하거나 "Tools/AudioLink/Add AudioLink Prefab to Scene" 메뉴 항목을 사용하세요.

VRC 아바타 테스트용

  1. AudioLinkAvatar/AudioLinkInput 아래에서 AudioSource의 AudioClip에 음악 트랙을 추가합니다.

  2. 아바타를 테스트하려면 플레이 모드로 들어가세요.

VRC Worlds 및 기타 사용 사례의 경우

  1. AudioLink MonoBehaviour의 "모든 사운드 반응 개체 연결..." 버튼을 클릭하여 모든 것을 연결합니다.

호환되는 도구/자산

  • Silent의 Silent Cel 셰이딩 셰이더

  • Mochie의 Unity 셰이더

  • Rollthered의 Fire Lite

  • AcChosen의 VR 무대 조명

  • Poiyomi 셰이더 - Poiyomi

  • orels1 orels1의 오디오링크 셰이더

  • VRC Things by _pi_

  • lethanan의 ShaderForge-AudioLink

  • Blabz의 AudioLink-USharpVideo-Adapter

  • ArchiTechAnon의 ProTV

감사합니다

  • 수학 마법, 개념적 프로그래밍, 디버깅, 디자인 지원 및 정서적 지원을 위한 포스페놀!!!

  • 새로운 DFT 스펙트로그램과 AudioLink를 100% 셰이더 코드로 포팅하는 데 도움을 준 cnlohr

  • 자동 상관기 기능을 위한 lox9973 및 신호 처리에 대한 영감 및 접선 수학 도움말

  • AudioLinkMiniPlayer 및 지원을 위한 Texelsaur!

  • 코드베이스와 영감을 강화하는 데 도움을 준 Pema!

  • 3은 AudioLink 팀에 합류하여 코드베이스 유지를 돕고 버전 0.3.0을 출시하는 데 중요한 역할을 해왔습니다.

  • UdonSharp를 만들고 그 과정에서 많은 조언을 제공한 Merlin입니다. 고마워요 멀린!

  • MaterialPropertyBlocks 및 셰이더와 쉬운 AV3 로컬 테스트를 위한 자동 구성 스크립트에 대한 모든 훌륭한 도움을 제공하는 Orels1

  • 개발 및 테스트에 도움을 주신 Xiexe

  • 로컬 AV3 테스트 기능 설정에 도움을 주신 Thryrallo

  • CyanEmu를 만들기 위한 CyanLaser

  • 여러모로 도와주고 정말 친절하게 대해준 Lyuma!

  • AudioLink.cginc의 명명된 텍스처 검사에 대한 ACIIL

  • 정말 멋지고 이 프로젝트에 좋은 느낌을 다시 반영해주셔서 감사합니다.

  • 오디오 데이터를 아바타에게 표시하는 아이디어를 고안한 Cthulu 대령

  • 수학 마법, 정서적 지원 및 영감을 주는 jackiepi

  • 내 불을 지펴준 Barry와 OM3!

  • 멋진 예시 음악과 영감을 주는 램프입니다. 팔로우하세요!! https://soundcloud.com/lampdx

  • 이 작품을 만들어주신 Shelter, Loner, Rizumu 및 VRChat의 다른 모든 댄스 커뮤니티 여러분

  • 편집기 테스트를 위한 yt-dlp 지원을 제안하고 구현한 rrazgriz

  • AudioLink의 CVR 포크를 유지하고 그들의 작업을 채택할 수 있도록 도와주신 LucHeart 및 DomNomNom

  • 데모 목적으로 음악을 제공해 주신 Rollthered님.

  • WebGL 지원을 알아보기 위한 기초

  • 다른 모든 기여자와 우리 커뮤니티의 도움과 지원

확장하다
추가 정보
관련 애플리케이션
추천
관련 정보 전체
사용자 리뷰