커스텀 레이어 API

프로토콜 버전 1.2

소개

mimoLive는 Apple의 쿼츠 컴포저 기술과 그 문서를 레이어에 사용합니다. mimoLive는 일부 환경 매개변수를 쿼츠 컴포저 문서에 전달하고 결과를 읽어들여야 하므로, mimoLive가 제공하는 모든 기능을 활용하기 위해 따라야 하는 프로토콜을 설계했습니다. 아래에서 이 프로토콜에 대한 모든 기술 정보를 확인할 수 있습니다.

쿼츠 컴포저로 커스텀 레이어를 만드는 방법을 알아보려면 "mimoLive용 고객 레이어 만들기":en:pro:custom_layer:creating_custom_layers를 참조하세요.

속성

쿼츠 컴포저에서 편집기 ⇢ 정보 편집 (⌥⌘I)을 선택해 프로토콜을 편집할 수 있습니다.

이름	필수	유형	샘플 값
카테고리		문자열
저작권		문자열	© 2016 MySoftwareCompany
설명		문자열	전체 화면 입력을 재생합니다.
이름	yes	문자열	전체 화면 플레이어
디펙티드 tv_Categories		문자열	배경, 전체 화면
tv_Debug		부울
tv_FileData_ 입력 이름-		데이터	(가져온 XML 파일)
tv_FileName_ 입력 이름-		문자열	Standings.xml
tv_HelpURL		문자열
tv_HiddenInputKeys		문자열 배열
tv_InputLabel_ 입력 이름-		문자열	비디오 입력
tv_LayerIdentifier	yes	문자열	com.example.layer.mylayer
tv_LayerVersion	yes	숫자(실수)	1.01
tv_LayerPreview		데이터	(가져온 PNG 파일)
tv_LayerProtocolVersion	yes	숫자(실수)	1
tv_SortKey		문자열
tv_StepSize_ 입력 이름-		숫자(실수)	0.1
디펙티드 tv_태그라인		문자열	전체 화면 입력을 재생합니다.
tv_UseAudioFromSource		문자열	tvIn_VideoSourceA
tv_UnitLabel_ 입력 이름-		문자열

카테고리

카테고리는 일반적으로 쿼츠 작곡가가 설정하며 mimoLive 레이어에는 필요하지 않습니다. mimoLive 카테고리의 경우 tv_Categories를 참조하세요.

저작권

저작권은 일반적으로 Quartz 작곡가가 설정하며 mimoLive 레이어에는 필요하지 않습니다.

설명

쿼츠 컴포저 표준 - 미리보기에서 잘 보이도록 3줄 정도로 길이를 유지합니다.

이름

이름은 mimoLive 내부에 표시됩니다. 짧고 고유한 이름을 사용하여 레이어를 빠르게 찾을 수 있습니다.

프로토콜

이 배열은 일반적으로 쿼츠 컴포저에서 설정하며, mimoLive 레이어에는 필요하지 않습니다.

tv_Categories

DEPRECATED

카테고리는 레이어를 그룹화하고 필터링하는 데 사용되었습니다. 현재는 무시되지만 다시 활성화될 수 있습니다. 쉼표로 구분된 다음 사전 정의된 카테고리 목록을 사용하거나 직접 정의하세요.

- "오디오" - 오디오 소스를 사용할 수 있는 레이어
- "오버레이" - 데이터 또는 이미지를 오버레이하는 레이어: Lower Thirds, 제목, 로고, ...
- "전체 화면" - 적어도 기본 설정을 통해 전체 화면을 제공하는 레이어 - 예: 애니메이션, 단일 비디오, 날씨 지도
- "배경" - 상단의 다른 항목의 배경/배경으로 작동하는 레이어.
- "텍스트" - 어떤 종류의 텍스트 표시를 제공하는 레이어, 예를 들어. 크레딧, Lower Thirds, 제목
- "데이터" - 데이터를 표시하는 레이어(예: 주식 시세, 농구 점수 등)
- "이미지" - 정적 이미지 입력을 사용하여 표시하는 수단을 제공하는 레이어
- "멀티비디오" - 아래 레이어에 하나 이상의 소스를 추가하거나 둘 이상의 소스를 사용하여 적어도 두 개의 소스를 결합하는 레이어입니다.
- "3D" - 요소의 3D 위치 지정(예: 프레젠터)을 제공하는 레이어
- "세그먼트" - 별도의 세그먼트에 시간 제한 애니메이션을 제공하는 레이어(예: 디지털 업그레이드 베이트트랙)
- "효과" - 일부 오버레이 효과(예: 돋보기, 스포트라이트, 줌...
- "데모" - 일반적인 유용한 기능을 제공하기보다는 주로 기능을 시연하는 데 사용되는 레이어(예.예: 독일 지도만 보여주는 날씨 지도
- "소비자" - 합성된 레이어 이미지를 사용하는 레이어(예: 비디오 전환기, 줌, 발표자
- "생성기" - 일종의 생성된 출력을 제공하는 레이어(예: 애니메이션
- "디버그" - 최종 제품에서 볼 수 없는 디버깅에 유용한 레이어입니다.

tv_Debug

이 컴포지션은 디버깅 환경에서만 사용해야 한다고 애플리케이션에 알립니다.

tv_FileData_

레이어 생성 시 파일 입력을 위해 생성되어 문서에 기록될 데이터 블롭입니다. 이는 _TypeFilePath에 제공될 텍스트 파일이나 이미지 입력용 .mov 파일에 사용됩니다. tv_FileName_ 을 참조하세요.

tv_FileName_

tv_FileData_에 해당하는 파일 이름입니다. tv_FileData_* 입력이 존재하는 경우 필수입니다.

tv_HelpURL

이 문자열은 이 레이어를 사용하는 방법에 대한 유용한 정보가 포함된 URL을 저장할 수 있습니다. mimoLive는 각 레이어의 정보 팝업창에 "?" 버튼을 표시합니다. 사용자가 이 버튼을 클릭하면 시스템의 기본 인터넷 브라우저에서 URL이 열립니다.

tv_HiddenInputKeys

이 배열에는 사용자 인터페이스에서 숨겨야 하는 입력 키가 포함되어 있습니다.

tv_InputLabel_

매개변수 보기에서 지정된 입력 키에 대한 대체 이름 레이블을 제공하는 데 사용할 수 있습니다. 레이블이 없는 빈 문자열도 가능합니다. tv_hide_output과 같이 작동하며, 프로토콜 입력 이름이 완전해야 합니다(예: "tv_InputLabel_tvIn_VideoSourceAImage").

tv_LayerIdentifier

식별을 위해 Boinx는 작곡을 배송하고 다른 버전을 분류했습니다. 고유해야 합니다. 도메인은 거꾸로 표기하는 것이 좋습니다. 예: com.mysoftware.layers.videofullscreen

tv_LayerVersion

문서/애플리케이션에서 서로 다른 버전의 컴포지션을 일치시킬 때 사용합니다. 주 버전 번호는 호환되지 않음을 나타내며 다른 주 버전과 일치하지 않습니다(예: 입력 키 이름이 변경되면 주 버전을 늘려야 함). 부 버전 번호는 상위 버전과 호환되어야 하며 각 반복마다 0.001씩 증가할 수 있습니다. 예를 들어 1.0 레이어에서 1.013으로 설정을 로드할 때 정확히 동일하게 표시되어야 하며, 이는 새 키가 있는 경우 표시되지 않거나 이전 버전의 모양과 동일한 기본값을 가져야 함을 의미합니다.

tv_LayerPreview

레이어 목록에서 레이어를 미리 보는 데 사용할 이미지 데이터입니다. 기본 빠른 보기 미리보기보다 더 나은 경험을 제공할 수 있습니다. 미리보기 이미지는 256×256픽셀이어야 합니다.

tv_LayerProtocolVersion

향후 mimoLive가 프로토콜을 크게 변경할 경우 이전 버전과의 호환성을 위해 설정합니다. 현재는 1로 설정해야 합니다.

tv_SortKey

mimoLive에서 레이어의 정렬을 정의합니다. 따라서 사용 확률에 따라 필터를 정렬할 수 있습니다. 현재 "BM", "DE", "DM" 등과 같이 2개의 대문자로 구성된 체계가 사용됩니다. 참고: 현재 이 기능은 사용되지 않지만 향후에 사용될 예정입니다.

tv_StepSize_

조그 휠에 사용자 지정 스텝 크기를 제공하는 데 사용할 수 있습니다. 1픽셀 마우스 움직임이 이 변화량(+/- 클릭)에 해당합니다.

tv_태그라인

<레이어 저장소의 정보 팝오버에 표시될 한 줄 문자열입니다.

tv_UseAudioFromSource

미모라이브는 현재 사용자 인터페이스에 하나의 오디오 컨트롤만 표시할 수 있습니다. 이 속성은 제어할 입력 키가 무엇인지 알려줍니다. 해당 입력 키를 모두 입력합니다. (이전 버전과의 호환성을 위해 이 필드에는 "A", "B" 또는 "C"도 허용되며, 이는 tvIn_VideoSourceAImage, tvIn_VideoSourceBImage 또는 tvIn_VideoSourceCImage 키로 변환됩니다. 제공되지 않으면 mimoLive는 이 레이어에 오디오가 사용되지 않는다고 가정합니다.

tv_UnitLabel_

매개변수 보기에서 주어진 입력 키에 대한 단위 레이블(예: "pt")을 제공하는 데 사용할 수 있습니다. 가능한 한 짧게 작성하세요. 입력의 의미를 전달하는 데 도움이 됩니다. Boinx 단위 입력에는 자동으로 "px" 레이블이 붙습니다.

입력

이름	유형
tvIn_AccountTwitterConsumerKey	문자열
tvIn_AccountTwitter소비자비밀	문자열
tvIn_AccountTwitterTokenKey	문자열
tvIn_AccountTwitterTokenSecret	문자열
tvIn_CompositedLayersImage	이미지
tvIn_FrameCount	색인
tvIn_FrameDuration	번호
tvIn_CompositedLayersImage	이미지
tvIn_InTransitionDirection	색인 전환 방향 방향
tvIn_인트랜지션 기간	번호
tvIn_인트랜지션 유형	색인 전환 유형 유형
tvIn_키보드모디파이어알트	부울
tvIn_키보드수정자명령	부울
tvIn_키보드모디파이어컨트롤	부울
tvIn_키보드모디파이어기능	부울
tvIn_키보드모디파이어시프트	부울
tvIn_Obscured	부울
tvIn_OnAir	부울
tvIn_OSVersion	문자열
tvIn_OutTransitionDirection	색인 전환 방향 방향
tvIn_OutTransitionDuration	번호
tvIn_OutTransitionType	색인 전환 유형 유형
tvIn_PreviewMode	부울
tvIn_Reset	부울(신호)
tvIn_런타임 식별자	문자열
tvIn_Shared_	모든 값 유형
tvIn_ShowDuration	번호
tvIn_쇼타이머	번호
tvIn_Switch	부울(신호)
tvIn_TransitionDirection	색인 전환 방향 방향
tvIn_TransitionDuration	번호
tvIn_TransitionType	색인 전환 유형 유형
tvIn_UISnapColor	색상
tvIn_VideoSourceA B C D	이미지

tvIn_AccountTwitterConsumerKey

tvIn_AccountTwitter소비자비밀

tvIn_AccountTwitterTokenKey

tvIn_AccountTwitterTokenSecret

이 네 개의 AccountTwitter 입력은 mimoLive 트위터 계정 환경 설정의 로그인 데이터를 컴포넌트에 공급하는 데 사용됩니다. 이 값은 트위터 서비스에서 데이터를 읽기 위해 JSON 패치 및 OAuth 패치와 함께 사용됩니다.

tvIn_CompositedLayersImage

이 입력이 컴포지션에 존재하고 아래 레이어의 콘텐츠가 있는 경우 아래 레이어의 드로잉 결과가 이 입력에 공급됩니다.

tvIn_FrameCount

이 입력은 mimoLive 시작 후 렌더링된 총 프레임 수를 가져옵니다. 렌더링 부하가 너무 높아서 프레임이 삭제된 경우 프레임 수는 삭제된 프레임 수를 뛰어넘습니다.

tvIn_FrameDuration

프레임 지속 시간은 각 렌더링 사이의 시간 간격(초)입니다.

tvIn_InTransitionDirection

전환 방향 - 전환 방향이 수행될 방향입니다.

tvIn_인트랜지션 기간

tvIn_InTransitionType이 수행될 초 단위의 값입니다.

tvIn_인트랜지션 유형

사용자가 진행 중인 전환 유형을 선택할 수 있는 레이어에 유용합니다. 또한 전환 유형 유형을 참조하십시오.

tvIn_키보드모디파이어알트

tvIn_키보드수정자명령

tvIn_키보드모디파이어컨트롤

tvIn_키보드모디파이어기능

tvIn_키보드모디파이어시프트

사용자가 키보드에서 해당 수정자 키를 누르는 동안 해당 부울 입력 필드는 참으로 설정됩니다. 이 기능은 주로 직접 조작 기능에 사용됩니다. UI에서 어떤 기능에 어떤 수정자 키를 사용해야 하는지 확인하려면 Apple 휴먼 사용자 가이드 라인을 참조하세요.

tvIn_Obscured

이 입력은 위의 레이어가 전체 화면을 그려서 출력을 렌더링할 필요가 없는 경우 true로 설정합니다. 이 입력은 표시되지는 않지만 라이브 상태로 설정된 레이어가 과도하게 그려지는 것을 방지하는 데 사용할 수 있습니다. (예를 들어 트위터 레이어의 경우 위의 다른 레이어에 가려져도 레이어가 호출되어 트위터 서비스에 대한 인터넷 연결을 계속 유지할 수 있습니다.)

tvIn_OnAir

이 입력은 "true" 값으로 시작합니다. 입력이 "false"로 바뀌면 컴포지션은 모든 나가는 전환을 수행한 다음 완료되면 완료 출력을 설정해야 합니다. 그러면 컴포지션이 비활성화됩니다. 애플리케이션이 완료 플래그를 기다리지 않고 레이어를 끄는 경우가 발생할 수 있습니다.

tvIn_OSVersion

이 문자열 입력은 현재 OS X 버전으로 설정됩니다(예: "버전 10.11.2(빌드 265341)").

tvIn_OutTransitionDirection

tvIn_OutTransitionType의 초 단위 값이 수행됩니다. 또한 전환 방향을 참조하십시오.

tvIn_OutTransitionDuration

tvIn_OutTransitionType의 초 단위 값이 수행됩니다.

tvIn_OutTransitionType

사용자가 진행 중인 전환 유형을 선택할 수 있는 레이어에 유용합니다. 또한 전환 유형 유형을 참조하십시오.

tvIn_PreviewMode

컴포지션이 미리보기 모드임을 알리는 데 사용할 수 있습니다.

tvIn_Reset

컴포지션의 로직을 재설정할 때 유용합니다. 이 플래그는 레이어가 꺼짐에서 라이브로 전환되거나 설정 간에 전환할 때 설정되며 tvIn_Switch 입력을 사용할 수 없을 때 설정됩니다.

tvIn_런타임 식별자

레이어가 미리보기와 라이브 인스턴스 간에 통신할 수 있도록 지원합니다. mimoLive에 의해 동적으로 설정됩니다.

tvIn_Shared_

레이어 간 값 공유 레이어 간 값 공유를 참조하세요.

tvIn_ShowDuration

사용자가 표시 설정에서 표시 기간을 입력한 경우 이 입력값은 초 단위로 표시됩니다.

tvIn_쇼타이머

쇼 타이머는 mimoLive 문서의 쇼 타이머 표시를 초 단위로 반영합니다.

tvIn_Switch

이 플래그는 레이어를 비활성화하지 않고 한 설정에서 다른 설정으로 전환할 때 [[tvIn_Reset]] 대신 설정됩니다. 이 입력이 없는 경우, 레이어를 비활성화하지 않고 한 설정에서 다른 설정으로 전환할 때 [[#tvIn_Reset이 설정됩니다. 이 입력이 존재하지 않는 경우 이전 레이어와의 호환성을 유지하기 위해 [[#tvIn_Reset]]이 대신 설정됩니다.

tvIn_TransitionDirection

전환 방향이 수행될 방향입니다.

tvIn_TransitionDuration

tvIn_InTransitionType의 초 단위 값이 수행됩니다.

tvIn_TransitionType

사용자가 진행 중인 전환 유형을 선택할 수 있는 레이어에 유용합니다. 또한 전환 유형 유형을 참조하십시오.

tvIn_UISnapColor

UI의 일관성을 유지하기 위해 mimoLive는 UI가 특정 값으로 스냅될 때마다 미리보기에서 가이드라인을 그릴 수 있는 "스냅 색상"을 제공합니다(예: 사용자 지정 디스플레이 모드에서 Placer 레이어를 회전하는 동안 "shift" 키를 누르고 있으면 회전 각도가 0, 45 또는 90도로 스냅될 때 가이드라인이 해당 색상으로 그려집니다).

tvIn_비디오소스

레이어에는 최대 8개의 동적 비디오 소스 입력이 가능합니다: "A", "B", "C" 등등. 사용자가 소스 저장소에서 레이어 스택으로 비디오 소스를 드래그하면 드롭 영역으로 표시됩니다. //참고: 이전 버전과의 호환성을 위해 해당 입력의 확장자 '이미지'는 무시됩니다.//.

입력 옵션

해당 입력 키

비디오 입력 키가 있는 경우 다음 입력 키에도 그에 따른 정보가 채워집니다:

(예: "tvIn_비디오소스A" -> "tvIn_비디오소스이름")

키	유형	설명
오디오 게인	번호	미정
오디오 레벨0	번호	게인 제어 후 왼쪽 오디오 채널 레벨 DB
오디오 레벨 1	번호	게인 제어 후 DB의 올바른 오디오 채널 레벨
오디오 레벨 0 원시	번호	게인 제어 전 왼쪽 오디오 채널 레벨 DB
오디오 레벨 1 원시	번호	게인 제어 전 올바른 오디오 채널 레벨(DB)
오디오 패닝	번호	미정
오디오 볼륨	번호	미정
데이터	Struct	소스의 메타데이터 사전입니다. 현재 구현된 키는 다음과 같습니다: "색인" "기간" "제목" "제목폴백" "아티스트" "앨범" "연도" "파일 참조 식별자"
이름	문자열	연결된 이미지 소스의 이름입니다. 미리 보기에 이름을 표시하거나 레이어 변형의 기본 이름을 계산하는 데 사용할 수 있습니다. 참조 tvOut_SettingName .
남은 시간	번호	몇 초 만에. 동영상 소스에 대해 제공됩니다. 동영상 소스가 반복되는 경우(또는 다른 소스) -1입니다.
TallyState	색인	연결된 소스의 집계 상태는 다음을 참조하세요. 집계 상태 상태
유형	색인	가치 소스 유형 유형

입력 그룹화

그룹화는 사용자 인터페이스에서 제공되며, 입력 접두사가 관련성이 있기 때문입니다. 구문은 tvGroup___과 같이 작동합니다. 그룹 이름 뒤에 이중 밑줄 _ _을 입력 이름과 구분하는 기호로 사용하세요.

항상 숨겨야 하는 입력에 대해 특별한 그룹이 정의됩니다: 디버그|디버그 환경설정|디버그 환경설정에서 이 그룹을 디버그 모드로 전환하여 표시할 수 있습니다. 일부 레이어는 이러한 숨겨진 필드를 사용하여 '미리보기 인스턴스'와 '라이브 인스턴스' 간에 통신합니다(예: 비디오 전환기 레이어는 미리보기 인스턴스에 현재 라이브 중인 비디오 소스를 알려줍니다).

동적으로 입력 숨기기

모든 프로토콜 입력은 tvOut_hide_ 출력이 "true"로 설정된 경우 UI에서 숨겨집니다. 이 값은 애플리케이션에서 관찰되며 동적으로 변경할 수 있습니다. "tvIn"을 포함한 전체 입력 이름을 사용해야 합니다(예: 입력 tvIn_Text_TypeMultiline에 대해 tvOut_hide_tvIn_Text_TypeMultiline 출력 사용).

출력

이름	유형
tvOut_Cursor	문자열
tvOut_Done	부울(신호)
tvOut_hide_	부울
tvOut_Opaque	부울
tvOut_SettingName	문자열
tvOut_Share_	모든 유형
tvOut_TimeRemaining	번호
tvOut_UseCompositedLayersImage	부울
tvOut_TallyState	색인 집계 상태 상태
tvSet_	설정할 입력 유형
tvSetSignal_	부울
tvSetAudioVolume_	번호
tvSetAudioVolumeSignal_	부울

tvOut_Cursor

이 출력은 마우스 포인터가 미리보기 또는 프로그램 출력 보기 위에 있을 때 마우스 커서의 모양을 지정합니다. 유효한 값은 Apples NSCursor 클래스 문서)를 참조하세요. mimoLive에서 제공하는 추가 마우스 커서는 "마이너스" 및 "플러스"입니다.

Apple의 NSCursor 상수에서 접두사 "_Cursor" 또는 "Cursor"를 제거합니다(예: 열린 손 마우스 커서를 가져오려면 "openHand"를 사용).

tvOut_Done

이 레이어가 완료되었음을 다음 레이어에 알리는 데 사용됩니다. 자세한 내용은 tvIn_OnAir 문서를 참조하세요.

tvOut_hide_

매개변수 보기에서 입력 값을 동적으로 숨기는 데 사용할 수 있습니다. 입력 동적으로 숨기기를 참조하세요.

tvOut_Opaque

이 레이어 아래에 있는 레이어를 그릴 필요가 없음을 애플리케이션에 알리는 데 사용됩니다. 기본값은 "false"입니다. 이 값은 알파를 포함하는 연결된 모든 소스에서 재정의됩니다.

tvOut_SettingName

컴포지션은 일부 입력을 기반으로 설정에 유용한 이름을 제안할 수 있습니다.

tvOut_Share_

레이어 간 값 공유를 참조하세요.

tvOut_TimeRemaining

애플리케이션에서 큰 타이머 카운트다운(예: 동영상이 완료될 때까지 5초)을 표시할 수 있습니다. 현재 남은 시간에 대한 정보가 없는 경우 '-1'을, 반복 동영상인 경우 '-2'를 사용합니다.

tvOut_UseCompositedLayersImage

트랜지션 등과 함께 아래 레이어를 사용할 때 성능을 최적화하는 데 사용됩니다. 현재 레이어에 합성 레이어 이미지 입력이 필요하다는 것을 앱에 알려줍니다. mimoLive는 다음 렌더링 주기에서 합성 이미지 아래에 레이어를 넣습니다. "tvOut_UseCompositedLayersImage"가 없는 경우 mimoLive는 항상 이미지 아래에 레이어를 넣어야 한다고 가정합니다. 드로잉 최적화만 가능하며, 그럼에도 불구하고 모든 미디어가 롤링됩니다. tvIn_CompositedLayersImage가 있는 경우에만 사용됩니다.

tvOut_TallyState

이 출력 레이어는 현재 해당 입력에 연결된 소스의 자동 탈리 상태를 덮어쓸 수 있습니다. 이는 전환에 유용하거나 소스가 출력에 사용되지 않는 경우 탈리 상태를 끌 수 있습니다(예: 비디오 스위처는 카메라 3대를 사용하지만 한 번에 하나만 표시하므로 사용하지 않는 소스의 탈리 상태를 "TVTallyStateOff"로 설정해야 합니다). 집계 상태 목록은 집계 상태를 참조하세요.

tvSet_

mimoLive에서 레이어 또는 필터는 자체 파라미터를 조작할 수 있습니다. 이는 주로 레이어 변형의 미리보기에서 직접 조작 기능을 구현하기 위한 것입니다(예: 사용자가 미리보기에서 아날로그 시계를 드래그하면, 레이어는 어떤 입력 키를 어떤 값으로 변경해야 하는지 mimoLive에 알려줍니다). 그러나 이 기능은 프로그램 출력 인스턴스에서 미리보기 인스턴스로 또는 그 반대로 라이브 데이터를 전송하는 데도 사용됩니다(예: 비디오 전환기 레이어에서 프로그램 출력 인스턴스는 미리보기 인스턴스에 현재 라이브 중인 비디오 소스를 알려주고 미리보기 인스턴스는 사용자가 화면에서 선택한 비디오 소스를 프로그램 출력 인스턴스에 알려줄 수 있음).

이 기능을 사용하려면 조작하려는 입력 필드에 해당하는 두 개의 출력이 필요합니다: 'tvSet_'에서는 설정하려는 새 값을 출력하고 'tvSetSignal_'에서는 값이 유효하고 저장할 때 신호를 보냅니다.

tvSetSignal_

tvSet_ 를 참조하세요.

tvSetAudioVolume_

이 출력은 연결된 오디오 소스(또는 비디오 소스의 오디오)의 볼륨을 제어합니다. 유효한 값은 0=무음에서 1=최대입니다. 컴포지션은 오디오 볼륨 레벨을 변경할 때마다 해당 "tvSetAudioVolumeSignal_"을 설정해야 합니다. 예를 들어 레이어에 페이드 인 전환이 있고 오디오도 페이드 인하려는 경우 유용합니다.

tvSetAudioVolumeSignal_

tvSetAudioVolume_ 를 참조하세요.

레이어 간 값 공유

레이어는 레이어 스택의 다른 레이어 위에 있는 레이어에 데이터를 전송할 수 있습니다. 데이터는 다음 렌더링 주기까지 공유 키에 의해 미몰라이브에 저장됩니다. 레이어가 여러 번 사용되거나 동일한 공유 키가 다른 레이어에서 사용되는 경우 데이터는 위의 레이어에 의해 덮어씌워집니다. 이 공유 데이터를 설정하려면 "tvOut_Share_" 출력을 사용합니다. 모든 쿼츠 컴포저 데이터 유형을 저장할 수 있지만 여러 값에 대해 하나의 출력만 필요하므로 구조체를 사용하는 것이 좋습니다. 수신 레이어 측에서는 데이터 유형이 동일한 "tvIn_Shared_" 입력이 필요합니다. 수신 레이어는 레이어 스택에서 송신 레이어 위에 있어야 한다는 점에 유의하세요.

값 공유는 여러 계층에서 동일한 데이터가 필요한 경우 유용합니다(예: 게임에서 홈 및 게스트 상대방의 이름).

유형 정의(일명: 명명 규칙)

키	유형	설명
*_TypeAudio	이미지	이것은 매우 특별한 경우입니다: 유형 오디오는 오디오가 포함된 소스(예: 동영상 소스, 비디오 소스 또는 오디오 전용 소스)만 할당할 수 있습니다. 레이어는 이 소스를 제어할 수 있을 뿐만 아니라 "_TypeAudioAudioLevel0" 및 "_TypeAudioAudioLevel1" 입력을 통해 왼쪽 및 오른쪽 채널의 오디오 볼륨 값도 제어할 수 있습니다(향후에).
*_TypeBoinxX	번호	Boinx X 좌표에 입력된 숫자(예: -1은 첫 번째 픽셀, 1은 현재 화면 치수의 마지막 픽셀)는 픽셀 단위로 사용자에게 표시됩니다.
*_TypeBoinxY	번호	Boinx Y 좌표에 입력된 숫자(예: -1은 맨 아래 픽셀, 1은 현재 화면 크기의 맨 위 픽셀)는 사용자에게 픽셀 단위로 표시됩니다.
*_타입디렉토리경로	문자열	결과적으로 UI에 "선택..." 버튼이 표시되고 경로 컨트롤이 표시될 수도 있습니다.
*_유형기간	번호	시간(초) - 분:초 단위로 표시되며 사용자 지정 UI를 얻을 수 있습니다.
*_TypeFilePath	문자열	결과적으로 UI에 "선택..." 버튼이 표시되고 경로 컨트롤이 표시될 수도 있습니다.
*_TypeFontBoinxSize	문자열	글꼴 크기(예: 2는 전체 화면 높이)는 아래 참고 사항 참조) Boinx Y 좌표로 표시합니다.
*_TypeFontColor	색상	텍스트 색상을 지정하는 일반 색상 입력은 아래 참고 사항을 참조하세요.
*_TypeFontName	문자열	이렇게 하면 글꼴 선택기가 나타납니다(아래 참고 사항 참조).
*_유형멀티라인	문자열	반환값을 입력할 수 있는 여러 줄 텍스트 필드입니다.
*_TypePassword	문자열	비밀번호 텍스트 상자를 표시합니다. 중요: 비밀번호 자체는 일반 텍스트로 저장되며 문서에서 읽을 수 있습니다!
*_TypeSignal	부울	단일 프레임 펄스 신호의 경우, 펄스 또는 감시자 패치를 사용합니다.

유형 글꼴 이름, 유형 글꼴 크기 및 유형 글꼴 색상 필드는 기본 레이블이 동일한 경우 레이어 매개변수 보기에서 하나의 글꼴 선택기 UI 요소로 결합됩니다.

필터 템플릿

이러한 입력 및 속성은 mimoLive에서 이미지 필터로 사용할 쿼츠 컴포지션을 생성하는 경우에만 해당됩니다. 이전 정의의 대부분은 필터에도 적용됩니다.

필터 입력

쿼츠 컴포저에서 필터 구성을 위해 필요한 입력 필드는 다음과 같습니다:

이름	유형	설명
_프로토콜 입력_프리뷰 모드	Bool	컴포지션이 미리보기 모드임을 알리는 데 사용할 수 있습니다.
_protocolInput_X	번호	는 항상 0입니다.
_protocolInput_Y	번호	는 항상 0입니다.

필터 속성

최신 버전의 필터와 업데이트 경로를 처리하려면 tv_FilterIdentifier 및 tv_FilterVersion이 필요합니다:

이름	유형	샘플 값	설명
tv_FilterIdentifier	문자열	com.boinx.mimoLive.layer.placer	식별을 위해 Boinx는 작곡을 배송하고 다양한 버전을 분류했습니다.
tv_FilterVersion	숫자(더블)	1	문서/애플리케이션에서 서로 다른 버전의 컴포지션을 일치시킬 때 사용합니다. 주 버전 번호는 호환되지 않음을 나타내며 다른 주 버전과 일치하지 않습니다. 부 버전 번호는 상위 버전과 호환되어야 하며 반복할 때마다 0.001씩 증가해야 합니다. 예를 들어 1.0 레이어에서 1.013으로 설정을 로드할 때 정확히 동일하게 표시되어야 하며, 이는 새로운 키가 있다면 표시되지 않거나 이전 버전의 모양과 동일한 기본값을 가져야 함을 의미합니다.
tv_FilterOutputIsOpaque	BOOL		필터 출력이 불투명할지 여부를 결정합니다. 기본값은 아니요

열거형

쿼츠 작곡가 유형 인덱스에서는 명명된 인덱스를 사용할 수 있습니다. 인덱스 모드에서 입력 분할기를 추가하여 쿼츠 컴포저 편집기에서 편집할 수 있습니다.

소스 유형

소스는 다음 값 중 하나입니다.

- 0 - 이미지
- 1 - 영화, 영화에는 남은 시간이 있습니다
- 2 - 카메라, 또한 구도일 수 있습니다.

전환 방향

직접 방향을 정의할 수 있습니다. 배송된 레이어는 다음 값을 사용합니다.

- 없음
- 왼쪽
- 오른쪽
- 위
- 아래

전환 유형

전환 유형을 직접 정의할 수 있습니다. 다음은 몇 가지 유용한 예시 값입니다.

- 녹이기
- 닦기

집계 상태

비디오 소스에 대한 여러 가지 집계 상태가 정의되어 있으며, UI와 Tally Light 컴패니언 앱에 표시됩니다.

- 0 = TVTallyStateOff
- 10 = TVTallyStateInUse
- 20 = TVTallyStatePreview
- 30 = TVTallyStateEffect
- 40 = TVTallyStateProgram