Giriş sesleri¶

Giriş sesi, bir hesabın bir ses kanalına bağlıyken çaldığı kısa bir ses klibidir. Hesap bir klibi kendi kitaplığına bir kez yükler, onu bir kapsama atar ve bir ses kanalının diğer katılımcıları için çalar. Özelliğin genel yapıdaki yeri Ses sayfasında anlatılır.

Bu sayfadaki her yol yalnızca kullanıcıya yöneliktir, hiçbir kanal izni gerektirmez ve çağıranın kendi kitaplığı üzerinde çalışır. Bot token'ı 403 ACCESS_DENIED ile reddedilir.

Klip sınırları¶

Desteklenen kapsayıcılar¶

TEBHOS kapsayıcı biçimini kodu çözülmüş baytlardan algılar; bu yüzden dosya adının, data: medya türünün veya bildirilen başka herhangi bir türün etkisi yoktur. Süre kapsayıcının kendisinden okunur ve süresi okunamayan bir dosya reddedilir.

FLAC, WebM, Matroska ve AIFF dahil diğer tüm biçimler reddedilir.

Kodu çözülmüş baytlar, tablonun atadığı uzantı ve içerik türüyle, geldikleri hâliyle birebir saklanır.

Giriş sesi nesnesi¶

Tek bir hesaba ait, saklanan tek bir ses klibi. name dışındaki her alan yükleme sırasında sabitlenir.

Yapı¶

Örnek¶

{
  "id": "1501314428688998182",
  "name": "airhorn",
  "hash": "9f2c41ab77de0135",
  "extension": "mp3",
  "content_type": "audio/mpeg",
  "duration_ms": 1240,
  "size_bytes": 20416,
  "url": "https://cdn.tebhos.com/entrance-sounds/1490000000000000000/9f2c41ab77de0135.mp3",
  "created_at": "2026-09-20T09:12:04.118+00:00"
}

Giriş sesi seçimi nesnesi¶

Bir kapsam ve ona atanmış klip.

Yapı¶

Atanmış sesi olmayan bir kapsamın seçim nesnesi yoktur.

Örnek¶

{
  "scope_id": "guild:1490000000000000123",
  "sound_id": "1501314428688998182"
}

Giriş sesi kapsamları¶

TEBHOS istemcileri şu kapsam değerlerini kullanır:

TEBHOS scope_id değerini gönderildiği gibi saklar ve biçimini doğrulamaz; bu yüzden bu değerlerden birini kullanın. Kapsamlar yalnızca istemci tarafındaki bir kuraldır: Giriş sesini çal klibi açıkça adlandırır ve bir kanala hangi seçimin uygulanacağına istemci karar verir.

Giriş seslerini listele¶

GET /users/@me/entrance-sounds

Geçerli hesabın giriş sesi kitaplığının tamamını, kapsam başına seçimleriyle birlikte döndürür.

Yanıt gövdesi¶

İki üye de her zaman bulunur ve hiçbir şey yüklememiş bir hesap için iki dizi de boştur.

Hız sınırı¶

user:entrance_sound:list kovasında, her kullanıcı için dakikada 30 istek.

Giriş sesi yükle¶

POST /users/@me/entrance-sounds

Tek bir ses klibinin kodunu çözer, doğrular ve geçerli hesabın kitaplığında saklar; oluşturulan giriş sesi nesnesiyle birlikte 201 döndürür.

JSON gövdesi¶

Doğrulama¶

Aşağıdaki her hata, insan tarafından okunabilir bir message ile 400 INVALID_FORM_BODY döndürür. Denetimler bu sırayla çalışır.

Yükleme sınırından (yaklaşık 1,4 MiB base64 artı 64 KiB) büyük bir istek gövdesi doğrulamadan önce reddedilir.

Yanıt¶

Yan etkiler¶

İşlem hiçbir kapsam atamaz ve hiçbir Gateway gönderimi (dispatch) yayınlamaz. Aynı baytları iki kez yüklemek, aynı hash ve url değerine sahip iki kitaplık girdisi oluşturur. Birini silmek diğerini kullanılabilir bırakır.

Hız sınırı¶

user:entrance_sound:upload kovasında, her kullanıcı için 5 dakikada 5 istek.

Giriş sesini yeniden adlandır¶

PATCH /users/@me/entrance-sounds/{sound_id}

Tek bir klibin görünen etiketini değiştirir ve güncellenmiş giriş sesi nesnesini döndürür.

Yol parametreleri¶

JSON gövdesi¶

Yanıt¶

Başka bir hesaba ait bir klip, hiç var olmamış bir klip gibi raporlanır.

Yan etkiler¶

Yalnızca etiket değişir. Klibe işaret eden seçimler ona işaret etmeye devam eder. Hiçbir Gateway gönderimi yayınlanmaz.

Hız sınırı¶

user:entrance_sound:mutate kovasında, her kullanıcı için dakikada 20 istek; Giriş sesini sil ve Giriş sesi seçimini ayarla ile paylaşılır.

Giriş sesini sil¶

DELETE /users/@me/entrance-sounds/{sound_id}

Geçerli hesabın kitaplığından tek bir klibi siler, ona işaret eden her seçimi temizler ve boş gövdeyle 204 döndürür. Bilinmeyen bir klip veya başka bir hesaba ait bir klip, hiçbir şey yapmayan başarılı bir işlemdir.

Yol parametreleri¶

Yanıt¶

Yan etkiler¶

Klip ve onu adlandıran her seçim kaldırılır. Kitaplıktaki başka bir klip aynı içeriğe sahip değilse saklanan ses dosyası da kaldırılır. Hiçbir Gateway gönderimi yayınlanmaz.

Hız sınırı¶

Paylaşılan user:entrance_sound:mutate kovasında, her kullanıcı için dakikada 20 istek.

Giriş sesi seçimini ayarla¶

PUT /users/@me/entrance-sound-selections

Bir klibi tek bir kapsama atar veya o kapsamı temizler ve boş gövdeyle 204 döndürür. Zaten sesi olan bir kapsamın üzerine yazılır. TEBHOS Pro gerektirir.

JSON gövdesi¶

TEBHOS, sound_id değerinin çağıranın kitaplığındaki bir klibi adlandırdığını denetlemez. İstemci yalnızca Giriş seslerini listele tarafından döndürülen kimlikleri göndermelidir (SHOULD).

Yanıt¶

Yan etkiler¶

Bir klip istenen sayıda kapsamda seçilebilir. Hiçbir Gateway gönderimi yayınlanmaz; bu yüzden çağıranın diğer oturumları değişikliği ancak kitaplığı yeniden listeleyerek öğrenir.

Hız sınırı¶

Paylaşılan user:entrance_sound:mutate kovasında, her kullanıcı için dakikada 20 istek.

Giriş sesini çal¶

POST /voice/channels/{channel_id}/entrance-sound

Bir ses kanalına bağlı diğer her hesaba çağıranın klibini çalmasını bildirir ve boş gövdeyle 204 döndürür. Çağıranın o kanalda bir ses bağlantısı olmalı ve klibin sahibi olmalıdır. TEBHOS Pro gerektirir. ENTRANCE_SOUND_PLAY yayınlar.

Alıcılar klibi olaydaki URL'den alır ve yerel olarak çalar.

Yol parametreleri¶

JSON gövdesi¶

Yanıt¶

Yan etkiler¶

TEBHOS, kanalda ses durumu olan diğer her hesaba, her hesap için en fazla bir kez ve çağırana hiçbir zaman olmamak üzere tek bir ENTRANCE_SOUND_PLAY gönderimi yollar. Gönderim hesaba yöneliktir; bu yüzden o hesabın sahip olduğu, kanalda olmayanlar dahil her oturum onu alır. İstemci channel_id değerine göre filtreler.

Hız sınırı¶

voice:entrance_sound:play kovasında, her kullanıcı ve kanal için 30 saniyede 3 istek.