![]() |
Publish파일을 Shotgun에 게시하기 위한 UI 및 기능을 제공합니다. |

이 앱은 레거시 게시 다중 앱입니다. 새 게시자에 대한 자세한 정보는 통합 사용자 안내서를 참조하십시오. 게시자는 아티스트가 Shotgun에 파일을 게시하는 데 사용할 수 있는 워크플로우 앱입니다. 이 앱은 원하는 대로 커스터마이즈할 수 있는 코어를 기반으로 단순한 UI를 제공하며 쉽게 구성할 수 있기 때문에 작업 씬 및 해당 종속성에서 어떠한 조합의 파일이나 데이터도 게시할 수 있습니다(예: Maya 씬, Nuke 스크립트, OBJ, Alembic 캐시, 카메라, 텍스처 등). Multi Publish 앱은 모든 기본 구성에서 사용되며 Maya의 Alembic 캐시 생성부터 Nuke에서의 게시 렌더링, Photoshop의 아트 참조 관리 또는 Shotgun 및 셸 환경에서의 플레이트 수집에 이르기까지 다양한 워크플로우를 지원하도록 쉽게 구성할 수 있습니다.
설명서
이 문서에서는 툴킷 구성에 대한 제어 권한이 있는 경우에만 사용할 수 있는 기능에 대해 설명합니다. 자세한 정보는 Shotgun 통합 사용자 안내서를 참조하십시오.
기본 인터페이스는 3개의 핵심 섹션으로 나뉩니다.

-
기본 출력. 게시할 항목은 해당 출력 유형별로 구성되며 UI의 맨 위에 강조 표시되는 기본 출력이 있습니다. 일반적으로 씬 파일 자체일 수 있는 기본 출력을 위해 게시할 항목은 정확히 하나가 있어야 합니다.
-
보조 출력. 보조 출력은 선택 사항이며 필요한 만큼 많이 있을 수 있습니다. 씬의 항목(예: Maya의 메쉬)은 필요한 경우 여러 보조 출력(예: Alembic 캐시 내보내기와 함께 OBJ 내보내기)과 연결할 수도 있습니다.
-
게시 상세 정보. 게시할 항목을 선택하는 것 외에도 인터페이스를 통해 아티스트는 Shotgun 태스크를 선택하고(현재 작업 영역에서 이미 지정하지 않은 경우) 썸네일을 캡처하고 코멘트를 추가할 수 있습니다.
앱을 사용할 때 아티스트 워크플로우는 일반적으로 다음과 같습니다.
- 앱을 시작하고 게시할 항목을 선택하고, Shotgun 태스크를 선택하고, 썸네일을 설정하고, 코멘트를 입력한 다음 'Publish'를 클릭합니다.
- 앱은 선택한 항목에 대한 사전 게시 유효성 확인 통과를 수행합니다.
- 문제가 있는 경우 계속할지 묻습니다. 계속하지 않을 경우 중지하고 문제를 표시하여 계속하기 전에 문제를 해결할 수 있습니다.
- 문제가 없거나 문제를 무시하라는 메시지가 표시되면 선택한 모든 항목을 기본 항목부터 게시합니다.
- 기본 항목이 성공적으로 게시되면 게시 후 단계를 실행하여 앱이 완료됩니다. 일반적으로 이 단계는 현재 씬의 버전을 증가시키고 정리하는 데 사용됩니다.
- 마지막으로 결과(성공 또는 실패)가 게시 단계에서 보고된 문제와 함께 표시됩니다.
Multi Publish 커스터마이즈
Multi Publish는 모든 주요 단계를 일련의 후크로 구현하여 원하는 대로 구성 가능하도록 디자인되었습니다. 이 후크는 앱에서 모든 엔진 관련 호출을 분리할 뿐만 아니라 새 엔진을 쉽게 구성할 수 있도록 게시 프로세스를 완벽하게 제어합니다.
다음은 게시 워크플로우를 함께 구성하는 주요 후크입니다.

- hook_scan_scene은 현재 씬을 스캔하여 게시할 항목을 검색합니다. 기본 항목을 여러 보조 항목과 함께 반환해야 합니다.
- hook_primary_pre_publish는 일반적으로 기본 항목을 게시할 수 있는지 유효성을 검사하는 후크입니다. 이 후크는 게시를 중지하지 않는 치명적이지 않은 문제의 목록을 반환할 수 있습니다.
- hook_secondary_pre_publish는 모든 보조 항목의 유효성 확인이 발생하는 후크입니다. 또한 사용자가 계속하기 전에 수정할 수 있도록 문제 목록을 반환할 수 있습니다.
- hook_primary_publish는 기본 출력을 위한 기본 항목을 게시합니다. 일반적으로 이 후크는 현재 씬 파일을 게시 영역에 복사하고 Shotgun에 등록하는 역할을 합니다. 게시된 파일의 전체 경로를 반환해야 하며 그런 다음 보조 게시 후크에 대한 종속성으로 전달됩니다. 이 후크 내에서 예외가 발생되면 게시를 중지하고 사용자에게 알립니다.
- hook_secondary_publish는 보조 출력을 위한 보조 항목을 게시합니다. 또한 일반적으로 게시된 파일을 내보내거나 복사한 다음 Shotgun에 등록합니다.
- hook_post_publish는 게시가 끝날 때 모든 정리 작업을 수행할 수 있는 게시 워크플로우의 마지막 후크입니다. 기본 후크에서는 이 경우 씬의 버전이 증가합니다. 예외를 발생시키지 않고 기본 게시가 성공한 경우에만 이 후크가 실행됩니다.
다음 추가 후크를 사용하여 앱의 동작을 커스터마이즈할 수 있습니다.
- hook_thumbnail은 화면 캡처를 수행하는 것이 의미가 없는 경우 게시용 썸네일을 제공하는 데 사용할 수 있습니다. 이 후크가 썸네일로 파일 경로를 반환하면 화면 캡처 기능이 비활성화됩니다.
-
hook_copy_file은 앱에서 디스크 기반 파일 복사를 수행하는 데 사용됩니다. 기본 후크는 앱의 유틸리티 메서드를 사용하여 결국 이 후크를 호출합니다. 이를 위해 후크 내에서
self.parent.copy_file(...)
을 호출합니다.
출력 및 항목
구성에 정의된 출력과 스캔-씬 후크에 의해 반환된 항목 간의 관계를 이해하는 것이 중요합니다.
각 출력에는 구성에 정의된 임의의 문자열인 scene_item_type
특성이 있습니다.
primary_scene_item_type
은 고유해야 합니다. 여러 개의 보조 출력이 동일한 scene_item_type
을 공유할 수 있습니다. 예를 들어 'OBJ' 및 'Alembic 캐시'와 같은 두 개의 보조 출력에 동일한 scene_item_type geometry
가 지정될 경우 씬의 모든 지오메트리 항목에 OBJ 및 Alembic 캐시 파일이 모두 게시되어야 한다는 것을 나타냅니다.
스캔-씬 후크에 의해 반환된 각 항목은 구성에 정의된 출력 중 하나의 scene_item_type
과 일치해야 하는 type
을 갖습니다.
앱은 출력의 scene_item_type
과 항목의 type
간 매핑을 사용하여 출력 목록과 항목 목록을 결합하고 사용자에게 최종 목록을 제공하여 게시할 각 출력에 대한 항목을 선택할 수 있도록 합니다.
관련 앱 및 문서
![]() |
씬 스냅샷Shotgun 스냅샷은 다른 사람과 공유하지 않고 작업의 버전을 만들고 증분을 관리할 수 있는 빠른 증분 백업입니다. 스냅샷을 만들고 설명과 썸네일을 추가하여 나중에 언제든지 다시 돌아가서 복원할 수 있도록 특정 시점 이미지를 생성합니다. 씬을 많이 변경할 때와 이전 버전의 씬을 확실히 백업해 두려는 경우 유용합니다. |
![]() |
Shotgun Workfiles이 응용프로그램은 Shotgun Pipeline Toolkit에서 파일 관리의 기초를 형성합니다. 이를 통해 여러 Shotgun 엔티티 사이를 빠르게 이동하고 작업을 신속하게 시작할 수 있습니다. 응용프로그램이 백그라운드에서 관리해 주기 때문에 경로를 지정할 필요가 없습니다. 이 응용프로그램을 사용하면 작업 영역 내에서 작업 파일을 관리하고 다른 사람들과 작업을 쉽게 공유할 수 있습니다. |
![]() |
Write Node이 앱에는 Nuke용 커스텀 Write Node 기즈모가 포함되어 있어 사용자의 파일 시스템 경로를 추출하여 특정 출력의 이름을 지정하는 데만 집중할 수 있습니다. 나머지는 Shotgun이 처리합니다. 이 앱은 일반적으로 Publish 앱과 함께 사용되며 Nuke용 Publish 앱을 설치할 경우 이 앱도 설치하는 것이 좋습니다. |
![]() |
Maya에서 Alembic 게시이 튜토리얼에서는 Maya에서 지오메트리 그룹을 게시할 때 Alembic 파일을 내보내도록 Multi Publish를 구성하는 방법을 보여 줍니다. |
![]() |
툴킷 파이프라인 튜토리얼이 문서에서는 보다 앞선 방법으로 단순한 전체 파이프라인을 설정하려는 TD(기술 디렉터)를 위해 단계별 튜토리얼을 제공합니다. 이 튜토리얼을 완료한 새 툴킷 사용자는 플랫폼의 기본 측면뿐만 아니라 스튜디오의 특정 요구 사항에 따라 플랫폼을 커스터마이즈하는 방법을 이해합니다. 이 튜토리얼에서는 기본 제공 툴킷 앱과 이를 아티스트 워크플로우에 맞게 조정하는 방법도 소개합니다. |
설치 및 업데이트
Shotgun Pipeline Toolkit에 이 앱 추가
이 앱을 이름이 asset인 환경에 있는 프로젝트 XYZ에 추가하고 싶다면 다음 명령을 실행합니다.
> tank Project XYZ install_app asset tk-maya tk-multi-publish
최신 버전으로 업데이트
프로젝트에 이 항목이 이미 설치되어 있는 경우 최신 버전을 얻으려면 update
명령을 실행할 수 있습니다. 특정 프로젝트와 함께 제공되는 tank 명령을 탐색하여 다음과 같이 실행할 수 있습니다.
> cd /my_tank_configs/project_xyz > ./tank updates
또는 스튜디오 tank
명령을 실행하고 업데이트 확인을 실행할 프로젝트 이름을 지정할 수 있습니다.
> tank Project XYZ updates
협업 및 개선
![]() |
Shotgun Pipeline Toolkit에 액세스할 수 있다면 모든 앱, 엔진 및 프레임워크가 저장 및 관리되는 Github에서 그 소스 코드에도 액세스할 수 있습니다. 이러한 항목을 자유롭게 개선하여 향후 독립적인 개발을 위한 기반으로 사용하고 변경 후 다시 풀 리퀘스트를 제출하거나, 아니면 그냥 조금만 손을 보고 어떻게 빌드되었는지, 툴킷이 어떻게 작동하는지 확인해 보십시오. https://github.com/shotgunsoftware/tk-multi-publish에서 이 코드 리포지토리에 액세스할 수 있습니다. |
특별 요구 사항
- 이 기능을 이용하려면 Shotgun Pipeline Toolkit Core API 버전 v0.14.58 이상이 필요합니다.
구성
아래는 사용되는 모든 구성 설정을 요약한 것입니다. 해당 설정은 이 앱 또는 엔진을 활성화하려는 환경 파일에서 정의해야 합니다.
hook_primary_publish
유형: hook
기본값: primary_publish
설명: 기본 태스크의 게시를 실제로 수행할 후크를 지정합니다. 이 후크는 게시해야 할 기본 태스크에 전달됩니다. 후크는 전체 게시 프로세스를 담당하며 게시를 Shotgun에 등록해야 합니다.
hook_post_publish
유형: hook
기본값: post_publish
설명: 게시 후 작업을 수행하는 데 사용될 후크를 지정합니다. 일반적으로 이 후크는 씬을 최신 버전으로 버전을 증가시키는 역할을 합니다.
display_name
유형: str
기본값: Publish
설명: 메뉴 및 기본 게시 대화상자에서 사용해야 하는 이름을 지정합니다.
primary_display_name
유형: str
기본값: Current Work File
설명: UI에서 기본 출력을 지정하는 이름입니다.
secondary_outputs
유형: list
설명: 설명할 내용이 없습니다.
primary_scene_item_type
유형: str
기본값: work_file
설명: 스캔 씬 후크에서 반환된 항목을 기본 출력과 일치시키는 데 사용되는 유형입니다.
allow_taskless_publishes
유형: bool
기본값: True
설명: 태스크가 지정되지 않은 경우 게시를 허용합니다. 게시는 현재 작업 영역의 엔티티에 연결됩니다.
hook_copy_file
유형: hook
기본값: copy_file
설명: 파일 'source_path'를 'target_path'로 복사할 후크를 지정합니다. 이 후크는 'copy_file' 유틸리티 함수에서 사용되며 후크 내에서 self.parent.copy_file(source_path, target_path, task)을 호출하여 다른 후크에서 액세스할 수 있습니다.
primary_publish_template
유형: template
설명: 파일 시스템 내에서 기본 게시된 파일을 찾는 데 사용되는 템플릿입니다. 값이 None이면 게시 후크 내에서 이를 결정해야 합니다.
primary_tank_type
유형: tank_type
설명: 이 설정은 기본 게시된 파일을 Shotgun에 등록할 때 사용되는 유형입니다. 설정되지 않은 경우 게시 후크 내에서 이를 결정해야 합니다.
template_work
유형: template
설명: 디스크에서 작업 파일을 찾는 템플릿에 대한 참조입니다.
hook_primary_pre_publish
유형: hook
기본값: primary_pre_publish
설명: 기본 게시 전에 실행할 후크를 지정합니다. 이 후크를 사용하여 전달할 기본 태스크에 대한 유효성 확인을 수행하여 게시할 준비가 되었는지 확인할 수 있습니다.
hook_scan_scene
유형: hook
기본값: scan_scene_{engine_name}
설명: 게시할 항목을 스캔할 후크를 지정합니다. 후크는 게시할 항목을 나타내는 목록 사전을 반환해야 합니다.
primary_icon
유형: config_path
설명: UI의 기본 출력에 사용되는 아이콘입니다.
expand_single_items
유형: bool
설명: 항목이 하나뿐인 경우 포함된 항목을 표시하기 위해 출력을 확장 가능하도록 해야 하는지 정의합니다.
hook_thumbnail
유형: hook
기본값: thumbnail
설명: 게시용 썸네일을 미리 생성하려면 후크를 지정합니다.
hook_secondary_publish
유형: hook
기본값: secondary_publish_{engine_name}
설명: 게시를 수행하는 데 사용될 후크를 지정합니다. 이 후크에는 게시할 보조 태스크 목록이 전달됩니다. 후크는 전체 게시 프로세스를 담당하며 게시된 파일을 Shotgun에 등록해야 합니다.
hook_secondary_pre_publish
유형: hook
기본값: secondary_pre_publish_{engine_name}
설명: 게시하기 전에 실행할 후크를 지정합니다. 이 후크를 사용하여 전달할 보조 태스크에 대한 유효성 확인을 수행하여 게시할 준비가 되었는지 확인할 수 있습니다.
primary_description
유형: str
기본값: Publish and version up the current work file
설명: UI에서 사용되는 기본 출력에 대한 설명입니다.