Ui Kitaplığı kullanım örnekleri

Uygulamalarınızda arama ve sohbet deneyimleri oluşturmak için Azure İletişim Hizmetleri Kullanıcı Arabirimi Kitaplığı'ndaki bileşenleri ve bileşikleri kullanın.

Bileşikte, çağrı ve sohbet özellikleri doğrudan yerleşiktir ve bileşik uygulamayı bir uygulamayla tümleştirdiğinizde kullanıma sunulur. Kullanıcı arabirimi bileşeninde arama ve sohbet özellikleri, kullanıcı arabirimi işlevselliği ve temel alınan durum bilgisi olan kitaplıkların bir bileşimi aracılığıyla kullanıma sunulur. Bu özelliklerden tam olarak yararlanmak için kullanıcı arabirimi bileşenlerini durum bilgisi olan çağrı ve sohbet istemci kitaplıklarıyla kullanmanızı öneririz.

Kullanıcı Arabirimi Kitaplığı hikaye kitabında daha fazla kavramsal belge, hızlı başlangıç ve örnek alın.

Arama kullanım örnekleri

Alan Kullanım örnekleri
Çağrı türleri Microsoft Teams toplantısına katılın.
Grup kimliği kullanarak bir Azure İletişim Hizmetleri çağrısına katılın.
bir Azure İletişim Hizmetleri odasına katılın.
Başka bir Azure İletişim Hizmetleri kullanıcısına giden bir çağrı başlatın.
Bir telefon numarasına giden arama başlatın.
Teams birlikte çalışabilirliği Arama lobisine katılın.
Transkripsiyon ve kayıt uyarısı başlığı görüntüleme.
Arama denetimleri Aramanın sesini kapatma ve açma.
Arama sırasında videoyu açma ve kapatma.
Ekran paylaşımını açın.
Aramayı sonlandır.
Katılımcı galerisi Uzak katılımcıları kılavuzda gösterme.
Yerel bir kullanıcı için yapılan aramada video önizlemesini kullanılabilir hale getirin.
Video kapalıyken varsayılan avatarları kullanılabilir hale getirin.
Katılımcı galerisinde paylaşılan ekran içeriğini gösterin.
Arama yapılandırması Mikrofon cihazını yönetin.
Kamera cihazını yönetin.
Hoparlör cihazını yönetin.
Kullanıcının video denetlemesi için yerel önizlemeyi kullanılabilir hale getirin.
Katılımcılar Katılımcı listesini gösterin.

Sohbet kullanım örnekleri

Alan sohbet Azure İletişim Hizmetleri Teams birlikte çalışabilirlik sohbeti
Sohbet türleri Azure İletişim Hizmetleri sohbet yazışmaya katılın. Microsoft Teams toplantı sohbetlerine katılın.
Sohbet eylemleri Kısa mesaj gönderme ve alma. Kısa mesaj gönderme ve alma.
Zengin metin iletileri gönderin ve alın.* Zengin metin iletileri gönderin ve alın.*
- Satır içi görüntüleri alma.
Dosya eklerini gönderme ve alma. Dosya eklerini alın.*
Sohbet olayları Yazma göstergelerini gönderme ve alma. Yazma göstergelerini gönderme ve alma.**
Okundu bilgilerini gönderme ve alma. Okundu bilgilerini gönderme ve alma.
Katılımcının ne zaman eklendiğini veya kaldırıldığını gösterir. Katılımcının ne zaman eklendiğini veya kaldırıldığını gösterir.
Katılımcılar Katılımcı listesini gösterin. Katılımcı listesini gösterin.

*Zengin kısa mesaj gönder ve dosya eki desteği şu anda genel önizleme aşamasındadır. Önizleme API'leri ve SDK'ları hizmet düzeyi sözleşmesi olmadan sağlanır. Bunları üretim iş yükleri için kullanmamanızı öneririz. Bazı özellikler desteklenmeyebilir veya kısıtlı özelliklere sahip olabilir. Daha fazla bilgi için Microsoft Azure Önizlemeleri için Ek Kullanım Koşulları'nı gözden geçirin.

**Teams kullanıcısından gelen yazma olayının görünen adı düzgün görünmeyebilir.

Desteklenen kimlikler

Bileşik bir öğe başlatmak ve hizmette kimlik doğrulaması yapmak için kullanıcının Azure İletişim Hizmetleri kimliği olmalıdır. Daha fazla bilgi için bkz. Azure İletişim Hizmetleri kimlik doğrulaması ve Hızlı Başlangıç: Erişim belirteçleri oluşturma ve yönetme.

Teams ile birlikte çalışabilirlik

Teams birlikte çalışabilirlik senaryolarında kullanıcı arabirimi Kitaplığı bileşiklerini kullanarak Azure İletişim Hizmetleri aracılığıyla teams toplantısına kullanıcı ekleyebilirsiniz. Teams birlikte çalışabilirliğini etkinleştirmek için çağrı bileşimindeki varsayılan özellikleri veya sohbet bileşimini kullanın. Özel bir deneyim oluşturmak için kullanıcı arabirimi bileşenlerini de kullanabilirsiniz.

Bir uygulamaya hem arama hem de sohbet eklediğinizde, katılımcı aramaya kabul edilene kadar sohbet istemcisinin başlatılabildiğini unutmayın. Katılımcı kabul ettikten sonra, toplantı sohbet yazışmasına katılmak için sohbet istemcisini başlatabilirsiniz. Desen aşağıdaki şekilde gösterilmiştir.

Arama ve sohbet için Teams birlikte çalışabilirlik düzenini gösteren diyagram.

Teams birlikte çalışabilirlik deneyimleri sunmak için UI bileşenlerini kullanıyorsanız, deneyimin önemli parçalarını oluşturmak için UI Kitaplığı örneklerini kullanarak başlayın:

  • Lobi örneği: Katılımcının aramaya kabul edilmeyi bekleyebileceği örnek bir lobi.
  • Uyumluluk başlığı: Çağrının kaydedilip kaydedilmediğini kullanıcıya gösteren örnek başlık.
  • Teams teması: Kullanıcı Arabirimi Kitaplığı öğelerinin Microsoft Teams gibi görünmesini sağlayan örnek bir tema.
  • Görüntü paylaşımı*: bir Azure İletişim Hizmetleri kullanıcısının Teams kullanıcısı tarafından gönderilen görüntüleri nasıl alabileceğini gösteren örnek.
  • Dosya paylaşımı*: bir Azure İletişim Hizmetleri kullanıcısının Teams kullanıcısı tarafından gönderilen dosya eklerini nasıl alabileceğini gösteren örnek.

Özelleştirme

Bileşenleri uygulamanızın görünümüne uyacak şekilde değiştirmek için UI Kitaplığı desenlerini kullanın. Özelleştirme, Azure İletişim Hizmetleri bileşikler ve kullanıcı arabirimi bileşenleri arasındaki önemli bir farktır. Bileşikler, daha basit bir tümleştirme deneyimi için daha az özelleştirme seçeneğine sahiptir.

Aşağıdaki tabloda özelleştirme kullanım örnekleri için bileşikler ve kullanıcı arabirimi bileşenleri karşılaştırılmaktadır.

Kullanım örneği Kompozit Kullanıcı arabirimi bileşenleri
Fluent tabanlı temalı kullanma. X X
Deneyim düzenini oluşturma. X
Stil özelliklerini değiştirmek için CSS stili kullanın. X
Simgeleri değiştirin. X
Katılımcı galerisi düzenini değiştirin. X
Arama denetimi düzenini değiştirin. X X
Kullanıcı meta verilerini değiştirmek için veri modelleri ekleyin. X X

Gözlemlenebilirlik

Kullanıcı Arabirimi Kitaplığı'nın durum yönetimi mimarisi ayrılmıştır, böylece durum bilgisi olan arama ve sohbet istemcilerine doğrudan erişebilirsiniz. Durumu okumak, olayları işlemek ve kullanıcı arabirimi bileşenlerine geçirmek için davranışı geçersiz kılmak için durum bilgisi olan istemciye bağlanın.

Aşağıdaki tabloda, gözlemlenebilirlik kullanım örnekleri için bileşikler ve kullanıcı arabirimi bileşenleri karşılaştırılmaktadır.

Kullanım örneği Kompozit Kullanıcı arabirimi bileşenleri
Arama ve sohbet istemci durumuna erişin. X X
İstemci olaylarına erişme ve olayları işleme. X X
Kullanıcı arabirimi olaylarına erişme ve olayları işleme. X X

Azure İletişim Hizmetleri erişim belirteci kullanarak bileşik ve temel bileşeni başlatın. yönettiğiniz güvenilir bir hizmet aracılığıyla Azure İletişim Hizmetleri erişim belirteçleri almak önemlidir. Daha fazla bilgi için bkz. Hızlı Başlangıç: Erişim belirteçleri oluşturma ve yönetme ve güvenilen hizmet öğreticisi.

Önerilen KULLANıCı Arabirimi Kitaplığı mimarisini gösteren diyagram.

Arama ve sohbet istemci kitaplıklarının katıldıkları arama veya sohbet bağlamı olmalıdır. Kendi güvenilen hizmetinizi kullanarak bağlamı istemcilere dağıtın. Örneğin, kullanıcı erişim belirteçlerini kullanın.

Aşağıdaki tabloda, istemci kitaplığına bağlam eklemek için gereken başlatma ve kaynak yönetimi işlevleri özetlenmektedir.

Contoso sorumlulukları UI Kitaplığı sorumlulukları
Azure'dan erişim belirteci sağlayın. Bileşenleri başlatmak için sağlanan erişim belirtecini geçirin.
Yenileme işlevi sağlayın. Geliştirici tarafından sağlanan bir işlev kullanarak erişim belirtecini yenileyin.
Arama veya sohbet için katılma bilgilerini alın ve geçirin. Bileşenleri başlatmak için arama ve sohbet bilgilerini geçirin.
Herhangi bir özel veri modeli için kullanıcı bilgilerini alın ve geçirin. İşlenmek üzere bileşenlere özel bir veri modeli geçirme.

Platform desteği

SDK Windows Mac OS Ubuntu Linux Android iOS
UI SDK'sı Chrome,* Microsoft Edge Chrome,* Safari** Krom* Krom* Krom* Safari**

*Chrome'un geçerli sürümü ve önceki iki sürüm desteklenir.

**Safari sürüm 13.1 ve sonraki sürümleri desteklenir. Safari macOS için giden video henüz desteklenmese de iOS için desteklenir. Giden ekran paylaşımı yalnızca masaüstü iOS'ta desteklenir.

Erişilebilirlik

Tasarım gereği erişilebilirlik, Microsoft ürünlerinde bir ilkedir. UI Kitaplığı bu ilkeyi izler ve tüm kullanıcı arabirimi bileşenlerine tam olarak erişilebilir.

Localization (Yerelleştirme)

Yerelleştirme, farklı dillerde konuşan dünyanın dört bir yanındaki kullanıcılar için ürün yapmanın anahtarıdır. UI Kitaplığı bazı diller ve özellikler için varsayılan destek sağlar. Bu destek sağdan sola dilleri içerir. Kullanıcı Arabirimi Kitaplığı ile kullanmak üzere kendi yerelleştirme dosyalarını sağlayabilirsiniz.

Bilinen sorunlar

Ui Kitaplığı şu anda mevcut iletileri düzenlerken ileti türünün güncelleştirilmesini desteklemez. Var olan bir iletiye zengin metin biçimlendirmesi eklemek, metin içeriğine HTML stili ekler. İleti türü değişmediğinden, sonuç ileti dizisinde düz metin olarak görünen HTML içeriği olabilir.

iOS ve ChatComposite Android uygulamalarınızda çağrı deneyimleri oluşturmak için ve Azure İletişim Hizmetleri KULLANıCı Arabirimi Kitaplığı'nda kullanınCallComposite. Birkaç kod satırı kullanarak, arama ve sohbet deneyiminin tamamını uygulamanızda kolayca tümleştirebilirsiniz. Azure İletişim Hizmetleri'deki bileşikler, kurulumdan arama ve sohbet sonuna kadar arama ve sohbetin tüm yaşam döngüsünü yönetir.

Kullanım örneklerini çağırma

Bu kullanım örneklerini oluşturmak için Azure İletişim Hizmetleri çağrısı bileşik kullanın.

Alan Kullanım örnekleri
Çağrı türleri Microsoft Teams toplantısına katılın.
Toplantı kimliği ve geçiş kodu kullanarak Microsoft Teams toplantısına katılın.
Grup kimliği kullanarak bir aramaya katılın.
Oda kimliği kullanarak aramaya katılın.
1:1 aramaları yapın ve alın.
Teams birlikte çalışabilirliği Arama lobisine katılın.
Transkripsiyon ve kayıt uyarısı başlığı görüntüleme.
Lobi katılımcılarını kabul etme veya reddetme.
Kapalı Açıklamalı Alt Yazılar Ekipler birlikte çalışabilirlik.
Grup araması, oda araması ve 1:1 araması.
Katılımcı galerisi Uzak katılımcıları kılavuzda gösterme.
Yerel bir kullanıcı için yapılan aramada video önizlemesini kullanılabilir hale getirin.
Video kapalıyken varsayılan avatarları kullanılabilir hale getirin.
Katılımcı galerisinde paylaşılan ekran içeriğini gösterin.
Katılımcı avatar özelleştirmesini etkinleştirin.
Katılımcı listesini gösterin.
Arama yönetimi Mikrofon cihazını yönetin.
Kamera cihazını yönetin.
Hoparlör cihazını (kablolu veya Bluetooth) yönetin.
Kullanıcının videosunu denetlemesi için yerel önizlemeyi kullanılabilir hale getirin.
Olaylara abone olun.
Arama denetimleri Aramanın sesini kapatma ve açma.
Arama sırasında videoyu açma veya kapatma.
Aramayı sonlandır.
Ses kesintisi sonrasında aramayı basılı tutun ve sürdürebilirsiniz.
CallKit ve TelecomManager desteği.
Deneyimi özelleştirme Düğme çubuğu özelleştirme.
Başlık ve alt başlık yapılandırması.
Arama sonu onay iletişim kutusu etkinleştirin.
Kurulum ekranını atlayın.

Arama tümleştirmesi

Bu bölümde çağrılar için tümleştirme ele alınmaktadır.

Teams ile birlikte çalışabilirlik

Teams birlikte çalışabilirlik senaryolarında kullanıcı arabirimi Kitaplığı bileşiklerini kullanarak Azure İletişim Hizmetleri aracılığıyla teams toplantısına kullanıcı ekleyebilirsiniz. Teams birlikte çalışabilirliğini etkinleştirmek için çağrı bileşimini kullanın. Bileşik, Teams birlikte çalışabilirlik çağrısına katılma yaşam döngüsünün tamamını yönetir.

Arama ve sohbet için Teams birlikte çalışabilirlik desenini gösteren diyagram.

Aşağıdaki şekilde, bir arayan Teams toplantısına eklenmeden önce kullanıcı deneyiminin bir örneği gösterilmektedir.

Bir arayan Teams toplantısına eklenmeden önce kullanıcı deneyimini gösteren ekran görüntüsü.

Odalar tümleştirmesi

Azure İletişim Hizmetleri, sanal randevular veya sanal etkinlikler gibi yapılandırılmış konuşmalar oluşturan geliştiriciler için bir oda kavramı sağlar. Odalar şu anda sesli ve görüntülü aramaya izin verir.

Oda, Azure İletişim Hizmetleri kullanıcılar arasındaki etkinliği yöneten bir kapsayıcıdır. Oda, uygulama geliştiricilerine bir aramaya kimlerin katılabileceğini, ne zaman toplantı yapabileceklerini ve nasıl işbirliği yapabileceklerini daha iyi denetleme olanağı sunar. Odalar hakkında daha fazla bilgi edinmek için kavramsal belgelere bakın.

Bir kullanıcı, aşağıdaki üç rolden birinde Odalar API'sini kullanarak bir odaya davet edilir:

  • Sunucu (varsayılan)
  • Attendee
  • Tüketici

Her rol arasındaki ayrım, kullanıldığında bir oda çağrısı CallComposite sırasında sahip oldukları özelliklerdedir. Her rolle ilişkili belirli özellikler Sanal odalara genel bakış bölümünde açıklanmıştır.

Oda yönetimini gösteren diyagram.

Not

Odalar API'si, oda oluşturma, kullanıcıları yönetme ve oda ömrünü ayarlama amacına hizmet eder. Odalar API'si, KULLANıCı Arabirimi Kitaplığı'ndan ayrı bir arka uç hizmetidir.

Bire bir arama ve ANıNDA iletme bildirimi desteği

Kullanıcı Arabirimi Kitaplığı, iletişim tanımlayıcısına göre kullanıcıları aramak için birebir VoIP çağrılarını destekler. Gelen çağrıyı almak için, KULLANıCı Arabirimi Kitaplığı bildirimlere PUSH kaydolmayı da destekler. Android ve iOS platformlarının tümleştirmesi ve API kullanımı hakkında daha fazla bilgi edinmek için bkz . Birebir arama yapma ve ANıNDA iletme bildirimleri alma.

Arama özellikleri

Arama için çeşitli özellikler mevcuttur.

Erişilebilirlik

Erişilebilirlik, çağrı kitaplıklarının önemli bir odağıdır. Arama durumu hakkında önemli duyurular yapmak ve görme engelli kullanıcıların uygulamayı kullandıklarında etkin bir şekilde katılabileceklerinden emin olmak için ekran okuyucu kullanın.

Kapalı açıklamalı alt yazılar

Kapalı açıklamalı altyazılar Teams ile birlikte çalışabilirlik, Azure İletişim Hizmetleri grup aramaları, oda aramaları ve bire bir aramalar gibi çok çeşitli senaryolara olanak tanır. Bu özellik, kullanıcıların çeşitli arama ortamlarındaki konuşmaları takip ederek erişilebilirliği ve kullanıcı deneyimini geliştirmesini sağlar.

Sistem konuşulan dili otomatik olarak algılamadığından kullanıcıların kullanıcı arabirimi kitaplığını kullanarak açıklamalı alt yazılar için dili el ile seçmesi gerekir.

Kullanıcı Arabirimi Kitaplığı'nda kapalı açıklamalı alt yazı tümleştirme deneyimini gösteren ekran görüntüsü.

Kapalı açıklamalı altyazılar hakkında daha fazla bilgi için açıklamaları ve kullanım yönergelerini gözden geçirmek için belgelere bakın. Kapalı açıklamalı altyazıları doğrudan KULLANıCı Arabirimi Kitaplığı'nın içinde yapılandırmak istiyorsanız, kolay kurulum için öğreticiyi izleyin.

Ekinlikler

Geliştiriciler artık özelliğindeki CallComposite olaylara abone olabilir. Bu özellik sayesinde, arama yaşam döngüsü boyunca belirli olaylara dinleyici ekleyebilirler. Bu geliştirme, daha fazla denetim ve özelleştirme fırsatı sağlar. Geliştiriciler, katılımcı katılımı veya aramadan ayrılan katılımcılar gibi olaylara göre özel eylemler tetikleyebilir. Ayrıca etkileşimleri günlüğe kaydetmek, kullanıcı arabirimlerini dinamik olarak güncelleştirmek veya genel işlevselliği geliştirmek için olayları kullanabilirler.

Daha fazla bilgi için bkz . Ui Kitaplığı'nda olayları işleme.

Localization (Yerelleştirme)

Yerelleştirme, farklı dillerde konuşan dünyanın dört bir yanındaki kullanıcılar için ürün yapmanın anahtarıdır. Kullanıcı Arabirimi Kitaplığı 12 dili destekler: İngilizce, İspanyolca, Fransızca, Almanca, İtalyanca, Japonca, Korece, Felemenkçe, Portekizce, Rusça, Türkçe ve Çince. Sağdan sola dilleri de destekler. Daha fazla bilgi için bkz . Uygulamanıza yerelleştirme ekleme.

Çoklu görev ve resim içinde resim modu

Kullanıcı Arabirimi Kitaplığı, arama ekranı için resim içinde resim modunu destekler. Bir arama sırasında, kullanıcılar arama ekranında geri düğmesini seçerek birden çok görevi önceki ekrana geri alabilir. Resim içinde resim modu etkinse, arama için bir sistem resim içinde resmi görüntülenir. Hem Android hem de iOS platformları ve API kullanımı için çoklu görev ve resim içinde resim modu hakkında daha fazla bilgi edinmek için bkz . Kullanıcı Arabirimi Kitaplığı'nı kullanarak resim içinde resmi açma.

Ekran yönü

UI Kitaplığı, kitaplık deneyiminin başlangıcından önce ekranların her biri için ayrı ayrı ekran yönlendirmesi kurulumunu destekler. Uygulama geliştiricileri, arama deneyimi için uygulama yönlendirmelerini uyumlu hale getirmeleri için sabit bir yönlendirme ayarlayabilir. Hem Android hem de iOS platformları için desteklenen yönlendirme listesi ve API kullanımı hakkında daha fazla bilgi edinmek için bkz . Ui Kitaplığı'nı kullanarak ekran yönlendirmesini ayarlama.

Ekran boyutu

beş inçten tablet boyutuna kadar ekran boyutlarına uyum sağlamak için Azure İletişim Hizmetleri çağrı kompozitini uyarlar. Dinamik katılımcıların liste düzenini elde etmek, görünümde netlik sağlamak ve konuşmaya odaklanmak için arama bileşiminde bölünmüş modu ve tablet modunu kullanın.

Bölme modu Tablet modu
Bölünmüş ekran görünümünü gösteren ekran görüntüsü. Tablet modunu gösteren ekran görüntüsü.

Veri eklemeyi görüntüleme

Yerel ve uzak katılımcılara aramada kullanıcı olarak nasıl göründüklerini özelleştirme seçeneği sunmak için mobil yerel platformlar için KULLANıCı Arabirimi Kitaplığı'nı kullanın. Yerel katılımcı, bir arama başladığında kurulum ekranında yerel bir avatar, özel görünen ad ve gezinti başlığını ve alt başlığı seçebilir. Uzak kullanıcı toplantıya katıldığında özelleştirilmiş bir avatar oluşturabilir. Daha fazla bilgi için bkz . Kullanıcı Arabirimi Kitaplığı'nda özel veri modeli ekleme.

iOS'ta önceden katılım deneyimini ve katılım deneyimini gösteren GIF animasyonu.

Paylaşılan içeriği görüntüleme

Mobil yerel platformlar için Kullanıcı Arabirimi Kitaplığı aracılığıyla, diğer katılımcılar Teams araması sırasında ekranlarını paylaştığında arama katılımcıları paylaşılan içeriği görüntüleyebilir. Uzak katılımcı, aramadaki paylaşılan içeriği yakınlaştırmak veya uzaklaştırmak için esnetme ve sıkıştırma hareketlerini kullanabilir.

İşletim sistemi tümleştirmeleri

İşletim sisteminizle tümleştirme.

CallKit desteği

UI Kitaplığı, çağrılar için etkileşimle CallKit başa çıkabilmek için tümleştirmeyi desteklerCallKit. iOS platformu tümleştirmesi ve API kullanımı hakkında daha fazla bilgi edinmek için bkz . CallKit'i UI Kitaplığı ile tümleştirme.

TelecomManager desteği

UI Kitaplığı artık ile TelecomManager tümleştirmeyi destekler ve çağrı bekletme ve sürdürme işlevlerinin işlenmesine olanak tanır. Android platformu tümleştirmesi ve API kullanımı hakkında daha fazla bilgi edinmek için bkz . TelecomManager'ı UI Kitaplığı ile tümleştirme.

Arama deneyimini özelleştirme

Arama deneyiminizi özelleştirebilirsiniz.

Yalnızca ses modu

Kullanıcı Arabirimi Kitaplığı'ndaki yalnızca ses modu, katılımcıların video paylaşmadan veya almadan yalnızca seslerini kullanarak aramalara katılmasına olanak tanır. Bu özellik bant genişliğini korumak ve gizliliği en üst düzeye çıkarmak için kullanılır. Etkinleştirildiğinde, yalnızca ses modu hem gönderme hem de alma akışları için video işlevlerini otomatik olarak devre dışı bırakır. Videoyla ilgili denetimleri kaldırarak kullanıcı arabirimini bu değişikliği yansıtacak şekilde ayarlar. Yapılandırma aracılığıyla CallComposite bu modu etkinleştirin. Daha fazla bilgi için Yalnızca ses hızlı başlangıcına bakın.

Arama sonu istemini devre dışı bırakma

Arama özelliklerini tümleştiren uygulamalar geliştirirken, sorunsuz ve sezgisel bir kullanıcı deneyimi sağlamak çok önemlidir. Kullanıcı deneyimini kolaylaştırabileceğiniz bir alan, arama sonlandırma işlemi sırasında gerçekleştirilir. Özellikle, geliştiriciler bir kullanıcı aramayı sonlandırmak istediğinde görüntülenen sol arama onay istemini devre dışı bırakmanın yararlı olduğunu düşünebilir. Bu özellik, yanlışlıkla çağrı sonlandırmalarını önlemede yararlı olsa da, özellikle hız ve verimliliğin kritik öneme sahip olduğu ortamlarda bazen kullanıcı deneyimini engelleyebilir. Daha fazla bilgi için bkz . Arama onayını devre dışı bırakma.

Hızlı tempolu iletişim ortamları: Ticaret katları, acil durum çağrı merkezleri veya müşteri hizmetleri merkezleri gibi ayarlarda kararlar ve eylemler hızlı bir şekilde gerçekleştirilmelidir. Çağrı sonlandırmayı onaylamanın ek adımı iş akışı verimliliğini engelleyebilir.

Düğme çubuğu özelleştirme

İşlev, geliştiricilerin bağlam menüsüne yeni eylemler eklemesine veya düğme çubuğundaki geçerli düğmeleri kaldırmasına olanak tanır. Özel eylemler sunma ve kullanıcı arabirimini belirli uygulama gereksinimlerine göre uyarlama esnekliği sağlayabilir.

  • Özel düğmeler ekleme: Geliştiriciler, özel eylemleri tetikleyebilmek için bağlam düğme çubuğuna yeni düğmeler ekleyebilir.
  • Mevcut düğmeleri kaldırma: Geliştiriciler kamera, mikrofon veya ses seçimi gibi arabirimi kolaylaştırmak için gereksiz varsayılan düğmeleri kaldırabilir.

Bu özelliğin uygulanması sırasında aşağıdaki kısıtlamaları göz önünde bulundurun:

  • Simgeler ve etiketler: Simgeler yalnızca yeni eylemler için eklenir. Düğme çubuğu simgeleri önceden tanımlanmış simgeleri tutar ve etiketler menü boyutuna uyacak şekilde kısa olmalıdır.
  • Erişilebilirlikle ilgili dikkat edilmesi gerekenler: Geliştiriciler, ekran okuyucular için uygun etiketleme de dahil olmak üzere tüm özel düğmelerin erişilebilir olduğundan emin olmalıdır.
Düğmeleri kaldır Özel eylemler ekleme
Alt çubuktaki kaldır düğmesini gösteren ekran görüntüsü. Bağlam menüsüne özel eylemler eklemeyi gösteren ekran görüntüsü.

Kullanım örnekleri

  • Özel arama içi eylemler: bir iş uygulaması, kullanıcıların arama sırasında teknik sorunları doğrudan bildirmesini sağlayan özel bir Rapor Sorunu düğmesi ekleyebilir.
  • Markalama ve kullanıcı deneyimi: Kurumsal bir uygulama, kullanım örneğiyle ilgisiz düğmeleri kaldırabilir ve kullanıcı deneyimini geliştiren markalı düğmeler ekleyebilir.

Tutarlı bir arama deneyimi sağlamak için Fluent UI simgelerini projenizle tümleştirmenizi öneririz. Bunlar Fluent UI GitHub deposunda kullanılabilir. Bunu yaptığınızda, özel simgeleriniz özelliğin tasarımıyla CallComposite eşleşerek uyumlu ve profesyonel bir görünüm oluşturur.

En iyi yöntemler

  • Temiz tasarım: Bağlamsal menü çubuğunu aşırı kalabalıktan kaçının. Yalnızca kullanıcı deneyimi için gerekli düğmeleri ekleyin.
  • Kullanıcı testi: Özelleştirmelerin kullanıcı gereksinimlerini karşıladığından ve bunları karıştırmadığından veya bunaltmadığından emin olmak için kullanıcı testi gerçekleştirin.
  • Geri bildirim mekanizması: Rapor Sorunu gibi düğmeler eklemek, toplanan geri bildirimleri işlemek için sağlam bir arka uç sisteminin kullanılabilir olmasını sağlar. Kullanıcı Arabirimi Kitaplığı'nın varsayılan olarak sağladığı mekanizmayı yeniden kullanın.

Daha fazla bilgi için bkz . Düğme çubuğunu özelleştirme.

Kurulum ekranını atla

UI Kitaplığı, arama birleştirme deneyiminin kurulum ekranını atlayarak bir çağrıya katılma özelliği sağlar. Varsayılan olarak, bir aramaya katılmak için kurulum ekranından geçersiniz. Burada, bir aramaya katılmadan önce kamera açma veya kapatma, mikrofon açma veya kapatma ve ses cihazı seçimi gibi arama yapılandırmasını ayarlarsınız. Bu ekran, kullanıcı etkileşiminin bir aramaya katılmasını gerektirir ve bu da bazı kullanıcılar için gereksiz olabilir. Bu nedenle kurulum ekranını atlayarak ve çağrı yapılandırma API'lerini sağlayarak bir çağrıya katılma özelliği sunuyoruz. Daha fazla bilgi için bkz . Kurulum ekranı özelliğini atlama.

Tema oluşturma ve renkler

Bir arayanın deneyiminin özel temasını oluşturmak için iOS ve Android için UI Kitaplığı çağrı bileşimini kullanın. Renk düzenini belirli marka gereksinimlerinize uyacak şekilde özelleştirebilmeniz için birincil renkleri özelleştirme esnekliğine sahipsiniz. Birincil renkleri ayarlayarak arabirimin markanızın görsel kimliğiyle tümleştirilmesini sağlayabilirsiniz. Uygulamalarınızda tutarlılığı korurken kullanıcı deneyimini geliştirebilirsiniz. Daha fazla bilgi için bkz . Temanızı oluşturma.

Android iOS
Arayan deneyimi için Android temalıyı gösteren ekran görüntüsü. Arayan deneyimi için iOS temalı işlemleri gösteren ekran görüntüsü.

Başlık ve alt yazı

Arama arabirimini özel gereksinimlerinize göre uyarlamayı kolaylaştıran özel dizeler eklemek için UI Kitaplığı'nı kullanın. Hem kurulum aşamasında hem de arama devam ederken bir çağrının başlığını ve alt başlığını özelleştirebilirsiniz.

Örneğin, kurumsal bir ortamda, toplantının gündemini yansıtacak başlığı ve duyuruyu belirtmek için alt başlığı ayarlayabilirsiniz. Müşteri desteği için, aracılar açıklığı ve iletişimi geliştirmek amacıyla sorgulamanın doğasını görüntülemek için başlıkları kullanabilir.

Zamana duyarlı tartışmalar içeren aramalar sırasında, tüm katılımcıların zaman kısıtlamalarını görüntüleyebilir ve arama süresini görüntülemek için alt başlığı da kullanabilirsiniz.

Daha fazla bilgi için bkz . Başlığı ve alt başlığı ayarlama.


Sohbet kullanım örnekleri

Önemli

Azure İletişim Hizmetleri'nin bu özelliği şu anda önizleme aşamasındadır.

Önizleme API'leri ve SDK'ları hizmet düzeyi sözleşmesi olmadan sağlanır. Bunları üretim iş yükleri için kullanmamanızı öneririz. Bazı özellikler desteklenmeyebilir veya kısıtlı özelliklere sahip olabilir.

Daha fazla bilgi için Microsoft Azure Önizlemeleri için Ek Kullanım Koşulları'nı gözden geçirin.

Alan Kullanım örnekleri
Sohbet türleri Azure İletişim Hizmetleri sohbet yazışmaya katılın.
Sohbet eylemleri Sohbet iletisi gönderin.
Bir sohbet iletisi alın.
Sohbet olayları Yazma göstergelerini gösterin.
Okundu bilgisini gösterme.
Katılımcının ne zaman eklendiğini veya kaldırıldığını gösterir.
Sohbet başlığındaki değişiklikleri gösterin.

Esneklik

ChatComposite özelliği, uygulamanızdaki farklı düzenlere ve görünümlere sığacak şekilde tasarlanmıştır. Örneğin, Sohbet'i gezinti görünümüne, kalıcı görünüme veya başka bir görünüme yerleştirmeyi seçebilirsiniz. ChatComposite özelliği kendini ayarlar ve kullanıcının sorunsuz bir deneyime sahip olmasını sağlar.

Gezinti görünümü Kalıcı görünüm
iOS'taki sohbet deneyimini gezinti görünümünde gösteren ekran görüntüsü. iOS'taki sohbet deneyimini kalıcı bir görünümde gösteren ekran görüntüsü.

Desteklenen kimlikler

Bileşik bir öğe başlatmak ve hizmette kimlik doğrulaması yapmak için kullanıcının Azure İletişim Hizmetleri kimliği olmalıdır. Daha fazla bilgi için bkz. Azure İletişim Hizmetleri kimlik doğrulaması ve Hızlı Başlangıç: Erişim belirteçleri oluşturma ve yönetme.

Azure İletişim Hizmetleri erişim belirteci kullanarak bir bileşik başlatın. yönettiğiniz güvenilir bir hizmet aracılığıyla Azure İletişim Hizmetleri erişim belirteçleri almak önemlidir. Daha fazla bilgi için bkz. Hızlı Başlangıç: Erişim belirteçleri oluşturma ve yönetme ve güvenilen hizmet öğreticisi.

Kullanıcı Arabirimi Kitaplığı için önerilen mimariyi gösteren diyagram.

Arama ve sohbet istemci kitaplıklarının katıldıkları çağrının bağlamı olmalıdır. Kendi güvenilen hizmetinizi kullanarak bağlamı istemcilere dağıtın. Örneğin, kullanıcı erişim belirteçlerini kullanın. Aşağıdaki tabloda, istemci kitaplığına bağlam eklemek için gereken başlatma ve kaynak yönetimi işlevleri özetlenmektedir.

Contoso sorumlulukları UI Kitaplığı sorumlulukları
Azure'dan erişim belirteci sağlayın. Bileşenleri başlatmak için sağlanan erişim belirtecini geçirin.
Yenileme işlevi sağlayın. Geliştirici tarafından sağlanan bir işlev kullanarak erişim belirtecini yenileyin.
Arama veya sohbet için katılma bilgilerini alın ve geçirin. Bileşenleri başlatmak için arama ve sohbet bilgilerini geçirin.
Herhangi bir özel veri modeli için kullanıcı bilgilerini alın ve geçirin. İşlenmek üzere bileşenlere özel bir veri modeli geçirme.

Platform desteği

Platform Sürümler
iOS iOS 14 ve üzeri
Android API 21 ve üzeri

Sorun giderme kılavuzu

Sesli veya görüntülü aramalarda sorun giderme işlemi gerçekleştiğinde bir arama kimliği sağlamanız istenebilir. Bu kimlik, Azure İletişim Hizmetleri çağrılarını tanımlamak için kullanılır.

Bu arama kimliğini almak için arama ekranının altındaki eylem çubuğunu kullanın. Tanılama bilgilerini paylaş'ı görmek için üç nokta düğmesini seçin. Destek ekibinin tüm sorunlarını izlemek için gereken tanılama bilgilerini paylaşmak için bu seçeneği kullanın.

Çağrı kimliğine programlı erişim için bkz . Program aracılığıyla hata ayıklama bilgilerini alma.

Sorun giderme hakkında daha fazla bilgi için bkz. Azure İletişim Hizmetleri'de sorun giderme.

Arama ekranı Tanılama bilgileri menüsü Arama kimliğini paylaşma
Arama sırasında arama ekranını gösteren ekran görüntüsü. Tanılama seçeneklerinin bulunduğu arama ekranını gösteren ekran görüntüsü. Contoso ile paylaşım çağrısı kimliğini gösteren ekran görüntüsü.