Ana içeriğe geç

Yeni Bir Pi Uygulaması Geliştirme

Pi Uygulamaları, JavaScript tabanlı Pi Editör arayüzü kullanılarak geliştirilir. Bu editör, çağrı akışının mantığını programlamak, ayarlarını yönetmek ve test kayıtlarını (loglarını) incelemek için entegre bir ortam sağlar.

Pi Uygulama Editörü'ne erişmek için:

  • Sol ana menüden Pi > Pi Uygulamaları yolunu izleyin.

    • Görsel

  • Açılan mağaza ekranında Uygulamalarım sekmesine geçiş yapın.

    • Görsel

  • Yeni bir uygulama oluşturmak için " Yeni Pi Uygulaması " butonuna tıklayın veya düzenlemek istediğiniz mevcut bir uygulamanın üzerine tıklayın.

    • Görsel

Bu işlem, sizi ilgili uygulamanın ana editör arayüzüne yönlendirir.

Uygulama Editörü Arayüzü​

Uygulama Editörü arayüzü, uygulamanın tüm bileşenlerini yönetmek üzere tasarlanmıştır. 

Arayüz aşağıdaki ana bölümlerden oluşur:

Parametreler (Sol Panel)​

Bu panel, uygulamanın dinamik verilerini (değişkenlerini) yönetmek için kullanılır.

  • Amaç: Akış mantığı (sağ panel) içerisine sabit değerler (örn: "Hoşgeldiniz" metni, "3000" ms bekleme süresi, "1234" dahili numarası) yazmak yerine, bu değerler "Parametre" olarak tanımlanır.
  • Avantajı: Uygulamanın çalışmasını etkileyen bir değeri (örn: anons metni) değiştirmek gerektiğinde, akış mantığına müdahale etmeden sadece bu panelden ilgili parametrenin değeri güncellenir. Bu, yönetimi kolaylaştırır ve hata riskini en aza indirir.

Kullanım: " Yeni Parametre Ekle " butonu kullanılarak yeni ayar alanları oluşturulabilir.

Görsel

Ana Akış Mantığı (Sağ Panel - Editör)​

Bu bölüm, uygulamanın "eylem planı"nın veya mantıksal reçetesinin bulunduğu yerdir. Sistem, bu paneldeki komutları yukarıdan aşağıya doğru sırayla işler.

Mantık: Uygulamanın çağrıya tam olarak ne yapacağını belirler. (Örn: Çağrıyı cevapla, anons oku, ses kaydı başlat, tuşlama bekle, çağrıyı kapat). Son kullanıcılar, akışın genel mantığını anlamak için bu bölümü inceleyebilirler.

Görsel

Teknik Not: Bu panelde kullanılabilen answer(), getDigitsWithTTS() gibi tüm Pi komut setinin (API) detaylı teknik dokümantasyonuna ve kullanım örneklerine şu adresten ulaşabilirsiniz:

https://developers.sanalsantral.com.tr/pi-v2/

 

Üst Menü Sekmeleri ve Kontroller​

Editörün üst kısmı, akış mantığı dışında kalan ayarları ve eylemleri yönetmek için kullanılır:Görsel

  • Editör Sekmesi: Aktif olarak Ana Akış Mantığının görüntülendiği ve düzenlendiği varsayılan sekmedir.
  • Ayarlar Sekmesi: Bu sekme, uygulamanın Pi Uygulama Mağazası'nda yayınlanması durumunda sahip olacağı yayıncı, versiyon, kategori, kapak görseli, etiketler ve fiyatlandırma bilgisini yapılandırmak için kullanılır.
  • Loglar Sekmesi: Uygulamanın "kayıt defteri" (kara kutu) olarak işlev görür. Bu uygulama her çalıştığında (her çağrı aldığında), hangi adımı ne zaman yaptığını, bir hata oluştuysa neden oluştuğunu veya akışın nerede kesildiğini görmek için bu sekme kullanılır. Hata ayıklama (debug) ve denetleme için kritik öneme sahiptir.
  • Kaydet Butonu: Arayüzün sağ üst köşesinde yer alır. Parametreler, akış mantığı veya ayarlar üzerinde yapılan tüm değişikliklerin saklanması ve aktif hale gelmesi için bu butona basılmalıdır.