Öğretici: oturumlarda ve cihazlarda uzamsal bağlayıcıları paylaşma
Azure uzamsal bağlantıları, zaman içinde cihazlarda konumlarını sürekli tutan nesneleri kullanarak karma gerçeklik deneyimleri oluşturabileceğiniz platformlar arası bir geliştirici hizmetidir.
Bu öğreticide, bir oturum sırasında bağlayıcı oluşturmak ve ardından bunları aynı cihazda veya farklı bir cihazla bulmak için Azure uzamsal bağlayıcılarını kullanırsınız. Aynı bağlayıcı aynı yerde ve aynı anda birden çok cihaz tarafından da bulunabilir.
Bu öğreticide aşağıdakilerin nasıl yapılacağını öğreneceksiniz:
- Bağlantıları paylaşmak için kullanabileceğiniz Azure 'da bir ASP.NET Core Web uygulaması dağıtın ve belirli bir süre için bağlantıları bellekte saklayın.
- Paylaşım bağlantıları web uygulamasından yararlanmak için, hızlı başlangıçlarımızın Unity örneğindeki AzureSpatialAnchorsLocalSharedDemo sahneyi yapılandırın.
- Bağlayıcıları dağıtıp bir veya daha fazla cihaza çalıştırın.
Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.
Ön koşullar
Bu öğreticiye başlamadan önce, aşağıdaki önkoşulları karşıladığınızdan emin olun:
- Azure uzamsal Tutturucuların genel bakışınıokuyun.
- 5 dakikalık hızlıbaşlangıçlardan birini doldurun.
Not
Android/NDK ve iOS/Swift quickbaşlangıçlarda, bu öğreticide açıklanan yetenekler Şu anda sunulmamaktadır.
- Temel bilgileri:
- Visual Studio 2019 veya üzeri bir Windows bilgisayarı ve ASP.net ve Web geliştirme iş yükü.
- .NET Core 3,1 SDK.
- Bir uygulamayı dağıtmak ve çalıştırmak için aşağıdaki cihazlardan biri veya daha fazlası: HoloLens, HoloLens 2, iOS veya Android.
Not
Bu öğreticide Unity ve bir ASP.NET Core Web uygulaması kullanıyorsunuz, ancak buradaki yaklaşım yalnızca Azure uzamsal bağlayıcı tanımlayıcılarının diğer cihazlarda nasıl paylaşılacağını gösteren bir örnek sağlamaktır. Aynı amaca ulaşmak için diğer dilleri ve arka uç teknolojilerini kullanabilirsiniz.
Uzamsal bağlayıcı kaynağı oluşturma
Azure Portal gidin.
Sol bölmede kaynak oluştur' u seçin.
Uzamsal bağlantıları aramak için arama kutusunu kullanın.
Uzamsal bağlayıcıları seçin ve ardından Oluştur' u seçin.
Uzamsal bağlayıcı hesabı bölmesinde şunları yapın:
Normal alfasayısal karakterleri kullanarak benzersiz bir kaynak adı girin.
Kaynağı iliştirmek istediğiniz aboneliği seçin.
Yeni oluştur seçeneğini belirleyerek bir kaynak grubu oluşturun. Myresourcegroup olarak adlandırın ve ardından Tamam' ı seçin.
Kaynak grubu , Web uygulamaları, veritabanları ve depolama hesapları gibi Azure kaynaklarının dağıtıldığı ve yönetildiği bir mantıksal kapsayıcıdır. Örneğin, daha sonra tek bir basit adımda kaynak grubun tamamını silmeyi seçebilirsiniz.
Kaynağın yerleştirileceği bir konum (bölge) seçin.
Kaynağı oluşturmaya başlamak için Oluştur ' u seçin.
Kaynak oluşturulduktan sonra, Azure portal dağıtımınızın tamamlandığını gösterir.
Kaynağa git’i seçin. Artık kaynak özelliklerini görüntüleyebilirsiniz.
Kaynağın hesap kimliği değerini daha sonra kullanmak üzere bir metin düzenleyicisine kopyalayın.
Ayrıca, kaynağın hesap etki alanı değerini daha sonra kullanmak üzere bir metin düzenleyicisine kopyalayın.
Ayarlar altında erişim anahtarı' nı seçin. Birincil anahtar değerini, hesap anahtarını daha sonra kullanmak üzere bir metin düzenleyicisine kopyalayın.
Örnek projeyi indirin
Aşağıdaki komutları çalıştırarak örnek depoyu kopyalayın:
git clone https://github.com/Azure/azure-spatial-anchors-samples.git
cd ./azure-spatial-anchors-samples
Paylaşım bağlantıları hizmetini dağıtma
Visual Studio 'yu açın ve ardından projeyi Sharing\sharingservicesample klasöründe açın.
Yayımlama sihirbazını açın
Çözüm Gezgini, sharingservice projesine sağ tıklayın ve ardından Yayımla' yı seçin.
Yayımla Sihirbazı başlatılır.
App Service > Oluştur App Service bölmesini açmak için App Service Yayımla ' yı seçin.
Azure'da oturum açma
Azure portalında oturum açın.
App Service oluştur bölmesinde Hesap Ekle' yi seçin ve ardından Azure aboneliğinizde oturum açın. Zaten oturum açtıysanız, açılan listeden istediğiniz hesabı seçin.
Not
Zaten oturum açtıysanız Oluştur öğesini henüz seçmeyin.
Kaynak grubu oluşturma
Kaynak grubu , Web uygulamaları, veritabanları ve depolama hesapları gibi Azure kaynaklarının dağıtıldığı ve yönetildiği bir mantıksal kapsayıcıdır. Örneğin, daha sonra tek bir basit adımda kaynak grubun tamamını silmeyi seçebilirsiniz.
Kaynak Grubu’nun yanındaki Yeni öğesini seçin.
Kaynak grubunu Myresourcegroup olarak adlandırın ve ardından Tamam' ı seçin.
App Service planı oluşturma
App Service planı, uygulamanızı barındıran web sunucusu grubunun konumunu, boyutunu ve özelliklerini belirtir. Web uygulamalarını tek bir App Service planı paylaşacak şekilde yapılandırarak birden çok uygulamayı barındırdığınızda paradan tasarruf edebilirsiniz.
App Service planları şunları tanımlar:
- Bölge (örneğin, Kuzey Avrupa, Doğu ABD veya Güneydoğu Asya)
- Örnek boyutu (küçük, orta veya büyük)
- Ölçek sayısı (1 ila 20 örnek)
- SKU (Ücretsiz, Paylaşılan, Temel, Standart veya Premium)
Barındırma Planı'nın yanındaki Yeni'yi seçin.
Barındırma planını Yapılandır bölmesinde, şu ayarları kullanın:
| Ayar | Önerilen değer | Açıklama |
|---|---|---|
| App Service planı | MySharingServicePlan | App Service planının adı |
| Konum | Batı ABD | Web uygulamasının barındırıldığı veri merkezi |
| Boyut | Ücretsiz | Barındırma özelliklerini belirleyen fiyatlandırma katmanı |
Tamam’ı seçin.
Web uygulaması oluşturma ve yayımlama
Uygulama adı alanına benzersiz bir uygulama adı girin. Geçerli karakterler şunlardır-z, 0-9 ve tireler (-) veya otomatik olarak oluşturulan benzersiz adı kabul eder. Web uygulamasının URL'si https://<app_name>.azurewebsites.net şeklindedir; burada <app_name>, uygulamanızın adıdır.
Azure kaynaklarını oluşturmaya başlamak için Oluştur’u seçin.
Sihirbaz tamamlandıktan sonra, ASP.NET Core Web uygulamasını Azure 'da yayımlar ve ardından uygulamayı varsayılan tarayıcınızda açar.
Bu bölümde kullandığınız uygulama adı, biçimdeki URL ön eki olarak kullanılır https://<app_name>.azurewebsites.net . Bu URL 'YI daha sonra kullanmak üzere bir metin düzenleyicisine kopyalayın.
Örnek uygulamayı dağıtma
Java Android örneği cihazlar arasında paylaşmayı destekler.
Android Studio ' de, Samples klasöründen Sharedactivity. Java dosyasını açın.
Önceki adımda kopyaladığınız URL 'YI (ASP.NET Web uygulaması Azure dağıtımından) SharingAnchorsServiceUrl sharedactivity. Java dosyasındaki değeri olarak girin.
index.htmlURL içindeki öğesini ile değiştirin api/anchors . Şöyle görünmelidir: https://<app_name>.azurewebsites.net/api/anchors .
Uygulamayı cihazınıza dağıtın.
Uygulama başladıktan sonra, bir demo seçin bölmesinde, localshare seçeneğini belirlemek için sol ve sağ okları kullanın. Sonra Git!' e dokunun.
Uygulamadaki yönergeleri izleyin. Oluşturma & paylaşım bağlantısı ' nı veya paylaşılan bağlayıcıyı bul' u seçebilirsiniz.
& paylaşımı oluştur ile, bir tutturucu oluşturup paylaşım hizmetinize kaydedebilirsiniz. Sonuç olarak, paylaşım hizmetinden almak için kullanabileceğiniz tanımlayıcıyı geri alacaksınız. Ardından, ikinci senaryoyu çalıştırabilir, cihazınızdan ya da farklı bir tane olan paylaşılan bağlayıcıyı bulabilirsiniz.
Paylaşılan bağlayıcıyı bul' u kullanarak, daha önce bahsedilen tanımlayıcıyı girerek daha önce paylaşılan bağlantıları bulabilirsiniz. Senaryonuzu seçtikten sonra uygulama, daha fazla yönerge için size kılavuzluk eder. Örneğin, ortam bilgilerini toplamak için cihazınızı taşımak isteyip istemediğiniz sorulur. Daha sonra, dünyanın içine bir bağlantı yerleştirip bunu kaydetmesi için bekleyin, yeni bir oturum başlatıp daha sonra bulmalısınız.
Kaynakları temizleme
Önceki adımlarda, bir kaynak grubunda Azure kaynakları oluşturdunuz. İleride bu kaynaklara ihtiyaç duymayacağınızı düşünüyorsanız kaynakları silmek için kaynak grubunu silebilirsiniz.
Azure portal menüsünde veya giriş sayfasında, kaynak grupları' nı seçin. Ardından, kaynak grupları sayfasında, myresourcegroup öğesini seçin.
Myresourcegroup sayfasında, listelenen kaynakların silmek istedikleriniz olduğundan emin olun.
Kaynak grubunu sil' i seçin, onaylamak için metin kutusuna myresourcegroup yazın ve ardından Sil' i seçin.
Sonraki adımlar
Bu öğreticide, Azure 'da bir ASP.NET Core Web uygulaması dağıttınız ve bir Unity uygulamasını yapılandırmış ve dağıttınız. Uygulamayla uzamsal bağlayıcı oluşturdunuz ve bunları ASP.NET Core Web uygulamanızı kullanarak diğer cihazlarla paylaştırmadınız.
ASP.NET Core Web uygulamanızı, paylaşılan uzamsal bağlayıcı tanımlayıcılarınızın depolanmasını sürdürmek için Azure Cosmos DB kullanacak şekilde geliştirebilirsiniz. Azure Cosmos DB destek ekleyerek, ASP.NET Core Web uygulamanızın bir bağlantı noktasını hemen oluşturmasını sağlayabilirsiniz. Daha sonra, Web uygulamanızda saklanan tutturucu tanımlayıcıyı kullanarak, uygulamanın daha sonra bağlayıcıyı yeniden bulması için gün döndürmesini sağlayabilirsiniz.