Publish 파일을 Shotgun에 게시하기 위한 UI 및 기능을 제공합니다. 최신 버전: v0.10.10(prod) 버전 번호의 경우 유의적 버전 표준을 따릅니다. 시스템 이름: tk-multi-publish

설명서

이 문서에서는 툴킷 구성에 대한 제어 권한이 있는 경우에만 사용할 수 있는 기능에 대해 설명합니다. 자세한 정보는 Shotgun 통합 사용자 안내서를 참조하십시오.

기본 인터페이스는 3개의 핵심 섹션으로 나뉩니다.

• 기본 출력. 게시할 항목은 해당 출력 유형별로 구성되며 UI의 맨 위에 강조 표시되는 기본 출력이 있습니다. 일반적으로 씬 파일 자체일 수 있는 기본 출력을 위해 게시할 항목은 정확히 하나가 있어야 합니다.

• 보조 출력. 보조 출력은 선택 사항이며 필요한 만큼 많이 있을 수 있습니다. 씬의 항목(예: Maya의 메쉬)은 필요한 경우 여러 보조 출력(예: Alembic 캐시 내보내기와 함께 OBJ 내보내기)과 연결할 수도 있습니다.

• 게시 상세 정보. 게시할 항목을 선택하는 것 외에도 인터페이스를 통해 아티스트는 Shotgun 태스크를 선택하고(현재 작업 영역에서 이미 지정하지 않은 경우) 썸네일을 캡처하고 코멘트를 추가할 수 있습니다.

앱을 사용할 때 아티스트 워크플로우는 일반적으로 다음과 같습니다.

1. 앱을 시작하고 게시할 항목을 선택하고, Shotgun 태스크를 선택하고, 썸네일을 설정하고, 코멘트를 입력한 다음 'Publish'를 클릭합니다.
2. 앱은 선택한 항목에 대한 사전 게시 유효성 확인 통과를 수행합니다.
   
3. 문제가 있는 경우 계속할지 묻습니다. 계속하지 않을 경우 중지하고 문제를 표시하여 계속하기 전에 문제를 해결할 수 있습니다.
4. 문제가 없거나 문제를 무시하라는 메시지가 표시되면 선택한 모든 항목을 기본 항목부터 게시합니다.
5. 기본 항목이 성공적으로 게시되면 게시 후 단계를 실행하여 앱이 완료됩니다. 일반적으로 이 단계는 현재 씬의 버전을 증가시키고 정리하는 데 사용됩니다.
6. 마지막으로 결과(성공 또는 실패)가 게시 단계에서 보고된 문제와 함께 표시됩니다.

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 통합 사용자 안내서를 참조하십시오.

설치 및 업데이트

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에서 사용되는 기본 출력에 대한 설명입니다.