일반
그리고 API를 활성화하면 "http://localhost:8989/api/v1"에서 사용할 수 있습니다. 기본값은 다음과 같습니다. URL 모든 메서드에 반드시 앞에 붙여야 하는 URL 아래에 나열되어 있습니다.
리소스가 처음 출시된 이후에 도입된 경우 HTTP API메서드에는 언제부터 사용 가능 정보.
/
지원되는 방법: "GET"
"/문서"에서 열려 있는 문서 목록으로 리디렉션됩니다.
문서
문서 쿼리하기
/문서
지원되는 방법: "GET"
열린 문서 목록이 반환됩니다. 반환된 개체에 어떤 정보가 포함되어 있는지 문서 데이터 유형을 참조하세요.
/문서/(문서ID)
지원되는 방법: "GET"
"(DocumentID)"로 지정된 단일 문서를 반환합니다. 응답의 포함된 섹션에는 이 문서에서 사용하는 모든 "레이어" 객체와 이 문서에 포함된 모든 "소스" 객체도 반환됩니다(사이드 로딩). 반환되는 데이터에 대한 자세한 내용은 문서 데이터 유형을 참조하세요.
/문서/(문서ID)/프로그램아웃
지원되는 방법: "GET"
"(DocumentID)"로 지정된 문서에서 현재 생성되는 프로그램 출력입니다.
소스 미리보기와 동일한 매개변수를 사용합니다.
문서 작업
/문서/(문서ID)/setLive
지원되는 방법: "GET" "POST"
쇼/문서를 시작하고 관련된 모든 이벤트를 트리거합니다. 이미 실행 중인 문서에서 이 함수를 호출해도 오류가 발생하지 않습니다. 업데이트된 문서 객체가 반환됩니다.
/문서/(문서ID)/설정해제
지원되는 방법: "GET" "POST"
쇼/문서를 중지합니다. 이미 중지된 쇼에서 이 함수를 호출해도 오류가 발생하지 않습니다. 업데이트된 문서 객체가 반환됩니다.
이 메서드를 호출한 후에도 문서가 계속 실행되도록 결정할 수 있으므로 반환된 레이어 객체는 "꺼짐"이 아닌 "종료" 상태가 될 수 있습니다.
/문서/(문서ID)/토글라이브
지원되는 방법: "GET" "POST"
쇼/문서를 라이브와 꺼짐 간에 전환합니다.
레이어
레이어 쿼리
/문서/(문서ID)/레이어
지원되는 방법: "GET"
"(DocumentID)"로 지정된 문서에 대한 레이어 목록을 반환합니다. 반환되는 객체에 대한 자세한 내용은 레이어 데이터 유형을 참조하세요.
/문서/(문서ID)/레이어/(레이어ID)
지원되는 방법: "GET", "PUT"
"(DocumentID)"로 지정된 문서에서 "(LayerID)"로 지정된 단일 레이어를 반환합니다. 응답의 "포함된" 섹션에는 이 레이어와 관련된 모든 "변형" 객체도 반환됩니다(사이드 로딩). 반환되는 데이터에 대한 자세한 내용은 레이어 데이터 유형을 참조하세요. 레이어 엔드포인트의 "입력 값"은 연결된 "liveVariant" 변형의 "입력 값"을 반영한다는 점에 유의하세요.
레이어 수정하기
지원되는 방법: "GET", "PUT"
레이어의 이름, 오디오 볼륨 또는 입력 값을 설정하려면 "PUT" 요청과 함께 JSON 인코딩된 객체를 레이어 엔드포인트에 추가합니다. 또는 "GET" 요청을 추가하여 JSON 데이터를 URL 키를 "?update="로 대체합니다. 이 경우 JSON 데이터는 다음과 같아야 합니다. URL 인코딩됩니다.
변경하고 싶지 않은 값은 간단히 제외해야 합니다. JSON 데이터. 예시:
{
"name": "New name of the Layer",
"volume": 0.5,
"input-values": {
"tvGroup_Content__Subtitle": "This is a Test"
}
}
값을 업데이트하면 mimoLive는 업데이트된 레이어 오브젝트로 응답합니다. 모든 값이 즉시 적용되지 않거나 다른 렌더링 사이클 후에야 효과가 나타날 수도 있습니다.
참고: "볼륨" 속성은 mimoLive 5.6에 추가되었으며 이전 버전 또는 레이어에 볼륨 컨트롤이 없는 경우 무시됩니다. 값은 (0, 1)로 클리핑되며, 0은 무음, 1은 최대 볼륨입니다.
레이어 작업
/문서/(문서ID)/레이어/(레이어ID)/setLive
지원되는 방법: "GET" "POST"
레이어를 활성화하며, 레이어에서 직접 호출하면 마지막으로 선택한 레이어 변형이 사용됩니다. 이미 활성화된 레이어에서 이 함수를 호출해도 오류가 발생하지 않습니다. 업데이트된 레이어 객체가 반환됩니다.
/문서/(문서ID)/레이어/(레이어ID)/설정해제
지원되는 방법: "GET" "POST"
레이어를 비활성화합니다. 이미 비활성화된 레이어에서 이 함수를 호출해도 오류가 발생하지 않습니다. 업데이트된 레이어 객체가 반환됩니다.
이 메서드를 호출한 후 레이어가 일부 애니메이션을 수행하기로 결정할 수 있으므로 반환된 레이어 객체는 "꺼짐"이 아닌 "종료" 상태가 될 수 있습니다.
/문서/(문서ID)/레이어/(레이어ID)/토글라이브
지원되는 방법: "GET" "POST"
레이어를 '라이브'와 '꺼짐' 간에 토글합니다.
/문서/(문서ID)/레이어/(레이어ID)/신호/(신호ID)
지원되는 방법: "GET" "POST"
현재 "라이브-배리언트"에서 "(SignalID)"로 지정된 신호를 트리거하거나 레이어가 "활성-배리언트"에서 라이브가 아닌 경우 트리거합니다. 레이어의 "입력값" 필드에서 "(SignalID)"를 가져올 수 있습니다(키 접미사 "_TypeSignal"로 식별).
/문서/(문서ID)/레이어/(레이어ID)/사이클스루변수
지원되는 방법: "GET" "POST"
사용 가능: 미모라이브 5.6 이후
레이어의 현재 활성 상태인 '(LayerID)' 레이어의 다음 배리언트를 레이어의 새 활성 배리언트로 선택합니다. 이는 라이브에 적용할 변형(예: Lower Third 레이어의 변형)을 선택하는 데 사용할 수 있습니다. 다음.
레이어가 현재 라이브 상태인 경우 이 엔드포인트를 호출해도 쇼가 방해받지 않습니다. 이 효과는 나중에 레이어가 라이브로 설정된 경우에만 표시됩니다.
변형
변수 쿼리하기
/문서/(문서ID)/레이어/(레이어ID)/변종
지원되는 방법: "GET"
"(LayerID)"로 지정된 레이어와 "(DocumentID)"로 지정된 문서에 대한 이형 상품 목록을 반환합니다. 반환되는 객체에 대한 자세한 내용은 "variants" 데이터 유형을 참조하세요.
/문서/(문서ID)/레이어/(레이어ID)/변종/(변종ID)
지원되는 방법: "GET", "PUT"
"(DocumentID)"로 지정된 문서에서 "(VariantID)"와 "(LayerID)"로 지정된 단일 이형 상품을 반환합니다. 반환되는 데이터에 대한 자세한 내용은 "variants" 데이터 유형을 참조하세요.
이형 상품 수정
이형 상품의 이름 또는 입력 값을 설정하려면 "PUT" 요청과 함께 JSON 인코딩된 객체를 변형 엔드포인트에 추가합니다. 변경하지 않으려는 값은 단순히 변형 엔드포인트의 JSON 당신 "PUT". 예시:
{
"name": "New name of the Variant",
"input-values": {
"tvGroup_Content__Subtitle": "This is a Test"
}
}
값을 업데이트하면 mimoLive는 업데이트된 변형 오브젝트로 응답합니다. 모든 값이 즉시 적용되지 않거나 다른 렌더링 사이클 이후에야 효과가 발생할 수 있다는 점에 유의하세요.
변형 작업
/문서/(문서ID)/레이어/(레이어ID)/변종/(변종ID)/setLive
지원되는 방법: "GET" "POST"
이형 상품을 활성화하며, 소유 레이어가 라이브가 아닌 경우 이형 상품도 라이브 상태로 전환됩니다. 이미 활성화된 이형 상품에서 이 함수를 호출해도 오류가 발생하지 않습니다. 업데이트된 이형 상품 객체가 반환됩니다.
/문서/(문서ID)/레이어/(레이어ID)/변종/(변종ID)/설정해제
지원되는 방법: "GET" "POST"
이형 상품을 비활성화합니다. 이렇게 하면 소유 레이어도 꺼집니다.
/문서/(문서ID)/레이어/(레이어ID)/바리언트/(변형ID)/토글라이브
지원되는 방법: "GET" "POST"
이형 상품을 라이브와 오프 사이를 전환합니다.
/문서/(문서ID)/레이어/(레이어ID)/변종/(변종ID)/신호/(신호ID)
지원되는 방법: "GET" "POST"
이형 상품에서 "(SignalID)"로 지정된 신호를 트리거합니다. 레이어의 "입력값" 필드(키 접미사 "_TypeSignal"로 식별)에서 "(SignalID)"를 가져올 수 있습니다.
출처
소스 쿼리하기
/문서/(문서ID)/소스
지원되는 방법: "GET"
"(DocumentID)"로 지정된 문서에 대한 소스 목록을 반환합니다. 반환되는 개체에 대한 자세한 내용은 "소스 레이어" 데이터 유형을 참조하세요.
/문서/(문서ID)/소스/(소스ID)
지원되는 방법: "GET", "PUT"
"(DocumentID)"로 지정된 문서에서 "(SourceID)"로 지정된 단일 소스를 반환합니다. 응답의 포함된 섹션에서 이 소스와 관련된 모든 "필터" 객체도 반환됩니다(사이드 로딩). 반환되는 데이터에 대한 자세한 내용은 "소스" 데이터 유형을 참조하세요.
/문서/(문서ID)/소스/(소스ID)/프리뷰
지원되는 방법: "GET"
"(DocumentID)"로 지정된 문서에서 "(SourceID)"로 지정된 소스의 그래픽 미리보기를 반환합니다. 엔드포인트는 다음 매개변수를 지원합니다:
매개변수 | 기본값 | 설명 |
---|---|---|
형식 | png | 미리보기가 반환되는 형식입니다. 허용되는 값: png, jpeg, mjpeg, mpng |
fps | 10 | 모션 이미지 미리보기의 프레임 속도입니다. mjpeg 및 mpng 형식에만 적용됩니다. 1fps는 대략 1%의 CPU 활용도. |
너비 | (문서 너비) | 미리보기의 최대 너비입니다. 이미지가 지정된 너비에 맞게 축소됩니다. |
높이 | (문서 너비) | 미리보기의 최대 높이입니다. 이미지가 지정된 높이에 맞게 축소됩니다. |
소스 수정하기
소스 이름 또는 입력 값을 설정하려면(예: 컴포지션 소스인 경우 등 소스에 있는 경우에만) "PUT" 요청과 함께 JSON 인코딩된 객체를 소스 엔드포인트에 추가합니다. 변경하지 않으려는 값은 단순히 소스 엔드포인트의 JSON 당신 "PUT". 예시:
{
"name": "New name of the Source",
"gain": 1.25,
"input-values": {
"tvGroup_Content__Subtitle": "This is a Test"
}
}
"게인" 속성은 mimoLive 5.6에 추가되었으며 이전 버전 또는 소스에 게인 컨트롤이 없는 경우 무시됩니다. 값은 (0, 2)로 클립되며, 0은 무음, 1은 기본값, 2는 볼륨을 약 두 배로 늘립니다.
소스 작업
/문서/(문서ID)/소스/(소스ID)/시그널/(시그널ID)
지원되는 방법: "GET" "POST"
소스의 "(SignalID)"로 지정된 신호를 트리거합니다(예: 컴포지션 소스인 경우처럼 소스에 "입력값"이 있는 경우에만 해당). 소스의 "입력값" 필드에서 "(SignalID)"를 가져올 수 있습니다(키 접미사 "_TypeSignal"로 식별).
필터
필터 쿼리
/문서/(문서ID)/소스/(소스ID)/필터
지원되는 방법: "GET"
"(SourceID)"로 지정된 소스와 "(DocumentID)"로 지정된 문서에 대한 필터 목록을 반환합니다. 반환되는 개체에 대한 자세한 내용은 "filters" 데이터 유형을 참조하세요.
/문서/(문서ID)/소스/(소스ID)/필터/(필터ID)
지원되는 방법: "GET", "PUT"
"(DocumentID)"로 지정된 문서에서 "(FilterID)"로 지정된 필터와 "(SourceID)"로 지정된 단일 필터를 반환합니다. 반환되는 데이터에 대한 자세한 내용은 "필터" 데이터 유형을 참조하세요.
필터 수정하기
입력 값을 설정하려면 "PUT" 요청과 함께 JSON 인코딩된 객체를 필터 엔드포인트에 추가합니다. 변경하지 않으려는 값은 간단히 필터 엔드포인트의 JSON 당신 "PUT". 예시:
{
"input-values": {
"tvGroup_Content__Subtitle": "This is a Test"
}
}
/문서/(문서ID)/소스/(소스ID)/필터/(필터ID)/신호/(신호ID)
지원되는 방법: "GET" "POST"
필터에서 "(SignalID)"로 지정된 신호를 트리거합니다. 필터의 '입력값' 필드에서 '(SignalID)'를 가져올 수 있습니다(키 접미사 "_TypeSignal"로 식별됨).
출력 대상
출력 대상 쿼리하기
/문서/(문서ID)/출력 대상
textileRef:9996801466400ba8908856:linkStartMarker:“지원되는 방법: "GET"
사용 가능: 미모라이브 4.2 이후
지정한 문서의 모든 출력 대상을 나열합니다.
반환된 개체에 대한 자세한 내용은 ""출력 대상" 데이터 유형":{TOPIC-""을 참조하세요.링크+데이터-타입시1(}. 섹션-출력-대상).
/문서/(문서ID)/출력 대상/(출력 대상 ID)
지원되는 메서드 “GETtextileRef:9996801466400ba8908856:linkStartMarker:”
사용 가능: 미모라이브 4.2 이후
"(OutputDestinationID)"로 지정된 출력 대상을 반환합니다.
반환된 개체에 대한 자세한 내용은 ""출력 대상" 데이터 유형":{TOPIC-""을 참조하세요.링크+데이터-타입시1(}. 섹션-출력-대상).
출력 대상 수정하기
/문서/(문서ID)/출력 대상/(출력 대상 ID)
지원되는 방법: "패치"
사용 가능: 미모라이브 4.2 이후
"(OutputDestinationID)"로 지정된 출력 대상의 선택된 속성을 업데이트합니다.
업데이트된 출력 대상을 반환합니다.
다음 속성을 수정할 수 있습니다:
- "title"
- "starts-with-show"
- "스톱-위드-쇼"
- "설정" 개체의 콘텐츠( 설정 설명. 섹션-개인-설정)에서 자세한 정보를 확인하세요.)
업데이트 설명은 JSONAPI 업데이트 형식 . 크러드 업데이트). 예시:
{
"data": {
"type": "output-destinations",
"id": "4FF003EA-D071-43FD-845F-DCD4A25DFA00",
"attributes": {
"title": "Our Recording",
"starts-with-show": true,
"settings": {
"location": "~/Movies"
}
}
}
}
출력 대상 작업
/문서/(문서ID)/출력 대상/(출력 대상 ID)/설정 라이브
지원되는 방법: "GET" "POST"
사용 가능: 미모라이브 4.2 이후
'(OutputDestinationID)'로 지정된 출력 대상이 올바르게 구성되고 라이브가 허용된 경우(예: mimoLive 라이선스 상태에 따라) 라이브가 시작되도록 합니다.
출력 대상이 라이브 상태가 되면 새로운 '라이브 상태'의 출력 대상이 반환되고, 그렇지 않으면 '409 충돌' 오류가 반환됩니다.
출력 대상은 라이브 스트림을 생성하기 위해 외부 서비스에 연결하는 등 라이브가 되기 전에 일부 작업을 수행해야 할 수 있으므로 반환된 출력 대상 개체는 "라이브" 상태가 아닌 "시작" 상태일 수 있습니다.
/문서/(문서ID)/출력 대상/(출력 대상 ID)/설정 해제
지원되는 방법: "GET" "POST"
사용 가능: 미모라이브 4.2 이후
"(OutputDestinationID)"로 지정된 출력 대상을 중지합니다.
출력 대상의 정지가 허용되면 출력 대상이 반환되고, 그렇지 않으면 "409 충돌" 오류가 반환됩니다.
출력 대상은 작업을 중지하기 전에 일부 작업을 수행해야 할 수 있으므로 반환된 출력 대상은 잘 구성된 출력 대상의 기본값인 '미리보기' 대신 '종료' 상태가 될 수 있습니다.
레이어 세트
레이어 세트는 mimoLive 5.0에 도입되어 여러 레이어의 라이브 상태를 한 번에 설정할 수 있어 경량화된 장면 를 사용하여 쇼의 다양한 상황을 연출할 수 있습니다. mimoLive에서만 생성 및 관리할 수 있습니다. API 액세스 권한이 획득 및 리콜 (활성화) 레이어 세트를 클릭합니다.
레이어 세트 쿼리하기
/문서/(문서ID)/레이어 세트
textileRef:9996801466400ba8908856:linkStartMarker:“지원되는 방법: "GET"
사용 가능: 미모라이브 5.0 이후
지정된 문서에 대한 모든 레이어 세트를 나열합니다.
반환된 개체에 대한 자세한 내용은 ""layer-sets"":{TOPIC-""데이터 유형"을 참조하세요.링크+데이터-typesh1(}. 섹션-레이어-세트).
/문서/(문서ID)/레이어세트/(레이어세트ID)
지원되는 메서드 “GETtextileRef:9996801466400ba8908856:linkStartMarker:”
사용 가능: 미모라이브 5.0 이후
"(LayerSetID)"로 지정된 레이어 세트를 반환합니다.
반환된 개체에 대한 자세한 내용은 ""layer-sets"":{TOPIC-""데이터 유형"을 참조하세요.링크+데이터-typesh1(}. 섹션-레이어-세트).
레이어 세트 액션
/문서/(문서ID)/레이어 세트/(레이어 세트ID)/리콜
지원되는 방법: "GET" "POST"
사용 가능: 미모라이브 5.0 이후
"(LayerSetID)"로 지정된 레이어 세트를 호출(활성화)하여 모든 레이어가 레이어 세트에 기록된 라이브 상태를 취하도록 합니다.
리콜 후, 즉 "active == true"로 설정된 레이어를 반환합니다.
데이터 저장소
/문서/(문서ID)/데이터스토어/(스토어ID)
지원되는 방법: "GET", "PUT", "삭제"
미모라이브는 사용자가 제공한 데이터를 문서 파일 안에 저장하는 기능을 제공합니다(예: 나중에 상태를 복원하기 위해). "StoreID"는 자유롭게 선택할 수 있지만 문서와 관련된 모든 데이터 저장소를 나열할 수 있는 방법은 없다는 점에 유의하세요(단, 일종의 색인 스토어가 다른 동적으로 명명된 스토어를 추적합니다).
데이터 저장소 생성/업데이트
데이터 저장소를 만들거나 업데이트하려면 "PUT" 요청을 요청 본문에 관련 데이터와 함께 선택한 "StoreID"로 전송합니다. 작업이 성공하면 미모라이브는 "200 OK" 상태로 응답합니다.
데이터 저장소의 콘텐츠 읽기
이전에 저장된 데이터 저장소를 읽으려면 "GET". 데이터는 "PUT"를 요청하여 저장합니다. 이 문서에 대해 해당 ID를 가진 데이터 저장소를 찾을 수 없는 경우 mimoLive는 "404 찾을 수 없음" 오류를 반환합니다.
기존 데이터 저장소 삭제
데이터 저장소가 더 이상 필요하지 않을 때 삭제하려면 "삭제"를 입력해 삭제하려는 'StoreID'를 요청하세요. 데이터 저장소가 애초에 존재하지 않는 경우 mimoLive는 "404 찾을 수 없음" 오류로 응답합니다.
사용 예
mimoLive HTTP API의 엔드포인트는 다양한 방식으로 활용될 수 있습니다. 자세한 내용은 API 사용 예시 섹션을 참조하세요.