TM Genel API

Tournament Manager (TM) Genel API'si, üçüncü taraf geliştiricilerin Tournament Manager yazılımıyla birlikte çalışabilen araçlar ve entegrasyonlar oluşturmasına olanak tanır. Bazı entegrasyon türlerine (örneğin, video veya ekran değiştiriciler) izin verilirken, diğerlerine (örneğin, alternatif maç zamanlayıcısı ekranları) izin verilmez. Bu makale TM Public API'sine genel bir bakış ve daha kapsamlı bilgilere ulaşabileceğiniz bir bağlantı sunmaktadır.

TM Public API nedir?

• API farklı yazılım uygulamalarının birbirleriyle iletişim kurmasını sağlayan kurallar ve araçlar kümesidir. TM Public API'nin amacı, VEX topluluğunun ileri düzey üyelerine kendi Turnuva Yöneticisi "uzantılarını" veya "eklentilerini" geliştirmeleri için resmi olarak tanınan bir fırsat sağlamaktır.
• Teşvik edilen/izin verilen entegrasyonlara örnekler şunlardır:
  • Bireysel yarışma karşılaşmalarının otomatik olarak kaydedilmesi ve/veya yüklenmesi
  • Etkin alanla ilişkili bir kamerayı seçmek için bir video değiştiriciyi kontrol etme
  • Makropad desteği ekleniyor
  • Bir PTZ kameranın aktif alana işaret etmesini kontrol etme
  • Çeşitli koşullara göre izleyici ekran seçimini otomatik olarak değiştirme
  • Komik derecede büyük bir "maç başlat" düğmesi yapma
• TM Public API henüz erken aşamalarındadır ve herhangi bir garanti olmaksızın "olduğu gibi" sağlanmaktadır. Gelecekte uyumluluğu korumayı umsak da, API'yi herhangi bir zamanda değiştirme veya durdurma hakkını saklı tutuyoruz.

Hangi işlevsellik olarak kullanılabilir?

• Maç programı / sonuçlar
• Sıralamalar
• Beceri sonuçları
• Etkinlik akışı (örneğin, maçların sahalara sıraya girdiği an, maç başlangıcı, vb.)
• Temel maç kontrol komutları (örneğin, başlat/durdur, bir sonraki maçı sıraya koy)

olan işlevselliklerden hangisi değildir?

• "Yaz" veya "düzenle" ile ilgili herhangi bir şey
• Puanları düzenleme veya gönderme
• Maç sırasında gerçek zamanlı bilgiler (örneğin, canlı skorlama)
• Takım bilgilerini düzenleme
• Etkinlik yapılandırmasını değiştirme (örneğin, alan kümeleri, maç programları oluşturma, vb.)

Etkinlik Ortağıyım; etkinliğimde üçüncü taraf araçları kullanmak istersem API'yi nasıl etkinleştirebilirim?

• Turnuva Yöneticisini açın ve Araçlar menüsünü, ardından Seçenekler'i seçin. Seçenekler penceresi açıldığında Web Yayıncılığı kategorisini seçin. “Yerel TM API’yi Etkinleştir” onay kutusunu işaretleyin ve değişiklikleri kaydedin.
• Bu işlemin her yeni etkinlik oluşturulduğunda yapılması gerekecektir.

Ben bir geliştiriciyim; TM API ile geliştirmeye nasıl başlayabilirim?

• Daha fazla bilgi Tournament Manager Public API Guidebulunabilir.
• Başlamak için bu bağlantıdan API kimlik bilgisi isteği gönderin ve üzerinde çalıştığınız şeyi bize anlatın. Endişelenmeyin; aşağıda listelenen yönergelere uygun olduğu sürece başvurunuz onaylanacaktır. Bu, daha sonra izin verilmeyecek bir şeye geliştirme enerjisi harcamadığınızdan emin olmanıza yardımcı olacaktır!

Kurallar & Yönetmelikler

• Üçüncü taraf uygulamalarının TM Genel API Kılavuzunda listelenen tüm teknik gerekliliklere uyması gerekir (örneğin, istek imzalama, Uygulama Kimliği, API anahtarları, vb.)
• Kullanıcının Araçlar > Ayarlar > Web Yayıncılığı > “Yerel TM API'yi Etkinleştir” yoluyla eklentiyi manuel olarak “katılımını” veya etkinleştirmesini gerektirmelidir.
• Beta API'de aşağıdaki şeyler teknik olarak mümkün olabilir, ancak açıkça yasaktır. Bu yönergeleri ihlal eden uygulamalar devre dışı bırakılacak ve API kimlik bilgileri iptal edilecektir.
  • API'nin Olay Akışı'nda yer alan bilgiler dışında, herhangi bir tür eşleşme zamanıgörüntülemek veya eşleşme zamanıyla ilgili herhangi bir şeyi değiştirmek.
    • Doğru zamanı tutmak ve bunu mümkün olan tüm cihazlarda doğru şekilde senkronize etmek, çekirdek TM kod tabanının birçok bölümüne iç içe geçmiş, şaşırtıcı derecede karmaşık bir sorundur.
    • Bu erişimin herkese açık bir API aracılığıyla sağlanmasının ne gibi istenmeyen sonuçlara yol açabileceğini tahmin etmek imkansızdır ve EP'leri ve ekipleri ekranlarında görüntülenen zamana güvenip güvenemeyeceklerinden emin olamayacakları bir duruma sokmak istemiyoruz.
  • Mevcut herhangi işlevi yeniden oluşturma (örneğin, kendi "TM Mobile"ınızı yapma)
    • Tutarlı bir temel etkinlik deneyimi sağlamak, REC Vakfı etkinlik modelinin temel ilkesidir. Takımlar, etkinliklerinde kullanılan temel araçların başka yerlerde kullanılanlarla aynı olduğuna ve bir etkinlikte deneyimi olan gönüllülerin, en küçük lig etkinliği veya en büyük İmza Etkinliği olsun, asgari eğitimle başka bir etkinliğe geçebileceğine güvenebilmelidir!
    • Mevcut bir fonksiyonun nasıl iyileştirilebileceğine dair fikirleriniz varsa, doğrudan bize bildirin! Gerçekten daha iyi bir kullanıcı deneyimi sağlayan değişiklikler doğrudan TM'ye yazılmalı ve tüm etkinliklerin erişimine açık olmalıdır.
  • Herhangi bir izleyici görüntüsünün değiştirilmesi veya yeniden oluşturulması
    • Yukarıda belirtilen tutarlılık notlarına ek olarak, resmi izleyici gösterimlerinde yer alan içerikler, REC Vakfı sponsorları, erişilebilirlik grupları ve pazarlama/marka yönetimi ekipleri arasındaki kritik tasarım & değerlendirme süreçlerinin sonucudur.
    • Tek bir olay bağlamında görüntü değişiklikleri masum görünse de, çoğu zaman REC Vakfı'nı daha geniş bir ölçekte etkileyen beklenmeyen sonuçlara yol açabilir (örneğin, sponsorluk anlaşmaları veya telif hakkıyla korunan bir görüntünün kullanımına ilişkin sınırlamalar).
  • Tournament Manager resmi açık API protokolleri dışında herhangi bir dahili bileşenine erişim veya değişiklik
    • Üçüncü taraflarca yapılan değişiklikler, resmi olmayan yollarla oluşturulduğunda, etkinliğin bütünlüğünü tehlikeye atma potansiyeli taşır. Resmi API giriş noktaları, bu riski en aza indiren veya ortadan kaldıran üçüncü taraf uzantıları için bilinen bir yol olarak kasıtlı olarak oluşturulmuştur.
    • Bu kanalların dışında yapılan değişiklikler, bu yönergelerin ihlali olmasının yanı sıra, EP'lerin veya takımların etkinliklerini yürüten yazılıma güvenemeyecekleri bir konuma düşmelerine neden olabilir.
• Not: Bu bizim için de keşfedilmemiş bir alan! Topluluğun ilgisini çekebilecek bazı TM Araçları fikirlerimiz olabilir, ancak yaratıcılığınız beklentilerimizi aşmaya devam edecektir. Dolayısıyla, TM Tools programı genişledikçe ve bundan neler çıkacağını görmeye başladıkça bu yönergelerin zamanla gelişmesi muhtemeldir!
• Hatırlatmak isteriz ki, resmi bir Eleme Etkinliğinde yetkisiz veya yasa dışı olarak değiştirilmiş yazılımın (yani bu kurallardan herhangi birini ihlal eden yazılımın) kullanımı yasaktır.
  • Geliştiriciler için bu durum API kimlik bilgilerinin iptal edilmesine ve uygulamalarının devre dışı bırakılmasına neden olacaktır.
  • Öğrenciler veya diğer takım üyeleri için bu durum REC Vakfı Davranış Kurallarıihlali olarak değerlendirilecektir.
  • Etkinlik Ortakları için bu durum, Etkinlik Mükemmelliğine Bağlılıkihlali olarak değerlendirilecektir.