TM 공개 API

토너먼트 관리자(TM) 공개 API를 통해 타사 개발자는 토너먼트 관리자 소프트웨어와 상호 운용되는 도구와 통합을 구축할 수 있습니다. 일부 유형의 통합(예: 비디오 또는 디스플레이 스위처)은 허용되지만, 다른 유형의 통합(예: 대체 경기 타이머 디스플레이)은 금지됩니다. 이 문서에서는 TM Public API에 대한 개요와 보다 포괄적인 정보에 대한 링크를 제공합니다.

TM 공개 API란 무엇인가요?

• 은 다양한 소프트웨어 애플리케이션이 서로 통신할 수 있도록 하는 규칙과 도구의 집합입니다. TM Public API의 목표는 VEX 커뮤니티의 고급 멤버가 자체 Tournament Manager "확장" 또는 "추가 기능"을 개발할 수 있는 공식적으로 인정된 기회를 제공하는 것입니다.
• 권장/허용된 통합의 예는 다음과 같습니다.
  • 개별 경쟁 경기를 자동으로 기록 및/또는 업로드
  • 활성 필드와 관련된 카메라를 선택하기 위해 비디오 스위처 제어
  • 매크로패드 지원 추가
  • 활성 필드를 가리키도록 PTZ 카메라 제어
  • 다양한 조건에 따라 관객 디스플레이 화면 선택을 자동으로 전환
  • 웃기게 큰 '경기 시작' 버튼 만들기
• TM 공개 API는 초기 단계이며, 어떠한 종류의 보증 없이 "있는 그대로" 제공됩니다. 우리는 미래에도 호환성을 유지하기를 바라지만, 언제든지 API를 수정하거나 중단할 권리를 보유합니다.

에서 까지 어떤 기능을 사용할 수 있나요?

• 경기 일정 / 결과
• 랭킹
• 기술 결과
• 이벤트 스트림(예: 경기가 필드에 대기하는 순간, 경기가 시작되는 순간 등)
• 기본 경기 제어 명령(예: 시작/중지, 다음 경기 대기)

중에서 로 사용할 수 없는 기능은 무엇입니까?

• "쓰기" 또는 "편집"과 관련된 모든 것
• 점수 편집 또는 제출
• 경기 중 실시간 정보(예: 라이브 스코어)
• 팀 정보 편집
• 이벤트 구성 수정(예: 필드 세트, 경기 일정 생성 등)

저는 이벤트 파트너인데, 이벤트에서 타사 도구를 사용하려면 API를 어떻게 활성화해야 하나요?

• 토너먼트 관리자를 열고 도구 메뉴를 선택한 다음 옵션을 선택하세요. 옵션 창이 열리면 웹 게시 범주를 선택합니다. "로컬 TM API 활성화" 확인란을 선택하고 변경 사항을 저장합니다.
• 이 작업은 새로운 이벤트를 생성할 때마다 수행해야 합니다.

저는 개발자입니다. TM API로 개발을 시작하려면 어떻게 해야 하나요?

• 자세한 내용은 토너먼트 관리자 공개 API 가이드에서 확인할 수 있습니다.
• 시작하려면 이 링크 에서 API 자격 증명 요청 제출하고 어떤 작업을 하고 있는지 알려주세요. 걱정하지 마세요. 신청하려는 내용이 아래 나열된 가이드라인에 부합하는 한 승인될 것입니다. 이렇게 하면 나중에 허용되지 않을 개발 에너지를 쏟지 않도록 하는 데 도움이 됩니다!

규칙 & 규정

• 타사 애플리케이션은 TM 공개 API 가이드에 나열된 모든 기술적 요구 사항(예: 요청 서명, 앱 ID, API 키 등)을 따라야 합니다.
• 사용자가 도구 > 설정 > 웹 게시 > "로컬 TM API 사용"을 통해 수동으로 "참여"하거나 애드온을 수동으로 활성화하도록 요구해야 합니다.
• 다음은 베타 API에서 기술적으로 가능할 수 있지만 명시 금지되어 있습니다. 이러한 지침을 위반한 것으로 밝혀진 애플리케이션은 비활성화되고 API 자격 증명이 취소됩니다.
  • API의 이벤트 스트림에 포함된 정보 외에, 매치 시간의 모든 유형을 표시하거나 매치 시간과 관련된 모든 내용을 수정합니다.
    • 정확한 시간을 유지하고 가능한 모든 장치에서 올바르게 동기화하는 일은 핵심 TM 코드베이스의 여러 부분에 얽혀 있는 놀라울 정도로 복잡한 과제입니다.
    • 공개 API를 통해 이에 대한 액세스를 제공하면 어떤 의도치 않은 결과가 발생할지 예측하는 것은 불가능하며, EP와 팀이 화면에 표시되는 시간을 신뢰할 수 없는 입장에 처하게 하고 싶지 않습니다.
  • 기존 기능 (예: 자체 "TM Mobile" 만들기)
    • 일관된 핵심 이벤트 경험을 유지하는 것은 REC Foundation 이벤트 모델의 기본 원칙입니다. 팀에서는 이벤트에서 사용하는 기본 도구가 다른 곳에서 사용하는 도구와 동일하다고 믿을 수 있어야 하며, 한 이벤트에서 경험이 있는 자원봉사자는 최소한의 훈련으로 다른 이벤트로 바로 이동할 수 있어야 합니다. 가장 작은 리그 이벤트든 가장 큰 시그니처 이벤트든 말입니다!
    • 기존 기능을 개선할 수 있는 아이디어가 있다면, 직접 알려주세요! 실제로 더 나은 사용자 경험을 제공하는 변경 사항은 TM에 직접 작성되어 모든 이벤트에서 사용할 수 있어야 합니다.
  • 개의 대상을 수정하거나 재생성하면표시됩니다.
    • 위에 언급된 일관성 참고 사항 외에도 공식 관객 디스플레이에 포함된 콘텐츠는 REC Foundation 스폰서, 접근성 그룹, 마케팅/브랜드 관리 팀 간의 중요한 디자인 & 검토 과정의 결과입니다.
    • 단일 이벤트의 맥락에서 디스플레이 수정은 무해해 보일 수 있지만, 종종 더 큰 규모로 REC 재단에 영향을 미치는 의도치 않은 결과를 초래할 수 있습니다(예: 후원 계약 또는 저작권이 있는 이미지 사용 제한).
  • 공식 오픈 API 프로토콜외부에서 Tournament Manager 의 내부 구성 요소에 액세스하거나 수정
    • 비공식적으로 이루어진 제3자의 수정은 이벤트 무결성을 손상시킬 수 있는 잠재적 위험을 초래합니다. 공식 API 진입점은 이러한 위험을 최소화하거나 제거하기 위해 타사 확장을 위한 알려진 경로로 의도적으로 만들어졌습니다.
    • 이러한 채널 외부에서 수정을 하면 이러한 지침을 위반하는 것 외에도 EP나 팀이 이벤트를 실행하는 소프트웨어를 신뢰할 수 없는 입장에 처할 위험이 있습니다.
• 참고사항: 이는 우리에게도 아직 탐험되지 않은 영역입니다! 우리는 커뮤니티에서 관심을 가질 만한 TM 도구에 대한 몇 가지 아이디어를 가지고 있을 수 있지만, 여러분의 창의력은 항상 우리의 기대를 뛰어넘습니다. 따라서 이러한 가이드라인은 TM 도구 프로그램이 확장되고 그 결과가 어떻게 될지 알게 됨에 따라 시간이 지남에 따라 발전할 가능성이 큽니다!
• 공식 예선 이벤트에서 승인되지 않았거나 불법적으로 수정된 소프트웨어(즉, 이러한 지침을 위반하는 소프트웨어)를 사용하는 것은 엄격히 금지되어 을 알려드립니다
  • 개발자의 경우 API 자격 증명이 취소되고 애플리케이션이 비활성화됩니다.
  • 학생이나 다른 팀원의 경우 이는 REC 재단 행동 강령위반으로 간주됩니다.
  • 이벤트 파트너의 경우 이는 이벤트 우수성에 대한 약속위반으로 간주됩니다.