iPhone Duo Menteşe Durumu: onHingeChange ve UIHingeInteraction

iPhone Duo menteşeye sahip ilk iPhone ve iOS 27.1 uygulamanızın bu menteşeyi okumasını sağlıyor. Cihazın kapalı mı, kısmen açık mı yoksa tamamen açık mı olduğunu öğrenebilir ve biri cihazı katlarken menteşe açısını tam olarak takip edebilirsiniz. Bu rehber, SwiftUI ve UIKit'teki iPhone Duo menteşe durumu API'lerini, bunları ne zaman kullanmanız ve ne zaman kullanmamanız gerektiğini, katlama hareketini şimdiden bir kontrole dönüştüren oyunlarla birlikte anlatıyor.

Ayrıntılar Apple'ın belgelerinden, Apple'ın iPhone Duo Tech Talk'larından ve forum yanıtlarından, ayrıca iOS geliştiricisi @sarunw tarafından paylaşılan bir gönderiden geliyor. Bu API'leri donanım üzerinde test etmedik. iOS 27.1 ve Xcode 27.1 ile geldiler; bu yüzden adlar ve davranışlar sonraki sürümlerde hâlâ değişebilir.

iPhone Duo hangi menteşe durumlarını bildirir?

@sarunw'un özetlediği gibi: "3 menteşe durumu var: closed, partiallyOpen ve fullyOpen." Apple'ın Leverage multiple displays and scenes on iPhone Duo Tech Talk'u aynı "üst düzey menteşe durumunu" tarif ediyor ve API'nin ayrıca "menteşe açısının sürekli güncellemelerini" sağladığını ekliyor.

Apple'ın belgeleri, durumun "sistem tarafından mevcut açıya ve cihaz yönüne göre belirlendiğini" söylüyor. Başka bir deyişle, kararlar için basit bir durum, akıcı hareket etmesi gereken her şey için de hassas bir açı alıyorsunuz.

Açı türü framework'e göre değişiyor. SwiftUI'de DeviceHinge.angle bir Angle. UIKit'te UIHinge.angle radyan cinsinden bir CGFloat.

SwiftUI'de .onHingeChange nasıl kullanılır?

SwiftUI API'si iOS 27.1'de kullanılabilen onHingeChange(isEnabled:_:). Eylemi, biri önceki biri yeni olmak üzere iki DeviceHingeContext değeri alır. Her bağlamda, angle ve status sunan DeviceHinge türünde isteğe bağlı bir hinge bulunur.

Apple'ın belgelerindeki bu örnek menteşeyi state'te saklıyor ve menteşe olmadığında bir yedek görünüm gösteriyor:

@State private var hinge: DeviceHinge? = nil

var body: some View {
    VStack {
        if let hinge {
            AngleDisplayView(angle: hinge.angle)
            StatusDisplayView(status: hinge.status)
        } else {
            ContentUnavailableView(
                "Hinge Unavailable",
                systemImage: "rectangle.split.2x1")
        }
    }
    .onHingeChange { _, newContext in
        hinge = newContext.hinge
    }
}

nil bir hinge, cihazda menteşe olmadığı anlamına gelir; bu durumu her zaman ele alın. isEnabled parametresinin varsayılan değeri true.

Eski ve yeni değerleri kullanmak

Closure her iki bağlamı da aldığı için cihazın kapandığı an gibi bir geçişi algılayabilirsiniz. Bu, yalnızca belgelenmiş türler üzerine kurulu kendi taslağımız:

.onHingeChange { oldContext, newContext in
    let wasClosed = oldContext.hinge?.status == .closed
    let isClosed = newContext.hinge?.status == .closed
    if !wasClosed && isClosed {
        game.closeLid()
    }
}

game.closeLid() burada sizin kendi kodunuzu temsil ediyor. Eski ve yeni değerleri karşılaştırmak, yalnızca açı değiştiğinde aynı eylemin iki kez çalışmasını önler.

UIKit'te menteşeyi UIHingeInteraction ile nasıl izlerim?

UIKit'te bir görünüme UIHingeInteraction ekleyin. İşleyicisi "menteşe durumu değiştiğinde veya etkileşim hiyerarşiler arasında taşındığında" çalışır. Görünüm menteşe güncellemeleri sağlayan bir hiyerarşiden ayrıldığında güncellemenin hinge değeri nil olur. Apple'ın örneği:

override func viewDidLoad() {
    super.viewDidLoad()

    let interaction = UIHingeInteraction { [weak self] _, update in
        guard let self else { return }
        // `hinge` değerinin nil olması, etkileşimin menteşe
        // güncellemeleri sağlayan bir hiyerarşiden ayrıldığını gösterir.
        guard let hinge = update.hinge else {
            handleHingeUnavailable()
            return
        }

        updateAngleDisplay(with: hinge.angle)
        updateStatusDisplay(with: hinge.status)
    }

    view.addInteraction(interaction)
}

Etkileşimin bir isEnabled özelliği de var. Menteşe bilgisini trait collection içinde aramayın. Bir Apple mühendisi geliştirici forumlarında menteşe duruşu için UITraitCollection özelliği bulunmadığını doğruladı.

Menteşe durumu düzenimi belirlemeli mi?

Hayır. En önemli kural bu. Apple'ın Tech Talk'u şöyle diyor: "Menteşe verisi canlı olarak izlenir ve etkileşimleri veya efektleri yönlendirmek için idealdir. Düzen için arrangement ve region API'lerini kullanın."

Bir Apple Technology Evangelist'i forumlarda en kolaydan en özele doğru dört yaklaşım sıraladı:

1. NavigationSplitView veya UISplitViewController gibi bir sistem kapsayıcısı kullanın.
2. Bu yeterli değilse ArrangementView veya UIArrangementViewController deneyin.
3. Yalnızca ikisi de işe yaramazsa görünümleri ayrılmış bölge (reserved region) API'leriyle konumlandırın.
4. Düzen kararları için onHingeChange veya hinge interaction API'sini kullanmayın.

Düzen için Apple'ın forumdaki yönergesi, cihaza özgü mantıktan kaçınmak ve cihaz açılıp kapandığında değişen boyut sınıflarını benimsemek. iPhone Duo boyut sınıfları, ArrangementView ve ayrılmış bölgeler ve katlama yeri rehberlerimiz bu araçları ele alıyor. Katlama yerinin bölme bölgesi yalnızca cihaz katlıyken etkin olur; yani ayrılmış bölgeler kıvrımın nerede olduğunu size zaten söylüyor.

Menteşe olayları harekete tepki vermesi gereken şeyler içindir: bir duvar kâğıdında yakınlaştırma efekti, katlamayla açılan bir kapak ya da bir oyun mekaniği. Apple'ın Tech Talk'u, kısmen katlanmış bir menteşenin whammy bar gibi çalıştığı bir gitar uygulaması geliştiriyor:

.onHingeChange { _, context in
    if let hinge = context.hinge, hinge.status == .partiallyOpen {
        pitchBend = calculatePitchBend(angle: hinge.angle)
    }
    else {
        pitchBend = 0
    }
}

Bükme yalnızca .partiallyOpen durumunda uygulanıyor, diğer durumlarda sıfırlanıyor. Apple calculatePitchBend fonksiyonunun gövdesini göstermiyor; açıdan efekte eşlemeyi nasıl yapacağınız size kalmış.

Masa üstü modu için nasıl tasarım yapmalıyım?

iPhone Duo bir masada "iç ekranı size dönük bir dizüstü bilgisayar gibi" durduğunda alt yarı sağlam bir taban, üst yarı ise kolayca bakılan bir yüzey olur. Apple'ın "Design for iPhone Duo" Tech Talk'u, "medyanın üstte durabileceğini, dokunulabilir kontrollerin ise alttaki sağlam tabanda yer alabileceğini" öneriyor.

Ancak bir püf noktası var. Apple, bu duruş için özel bir düzenin "diğer duruşlarla aynı kontrolleri ve genel hiyerarşiyi" koruması gerektiğini ekliyor, çünkü "işlevselliği belirli bir duruşa bağlamak istemezsiniz." Uygulamalar için bu, masa üstü modunun içeriği yeniden düzenleyebileceği, ancak her özelliğin cihaz düz veya kapalıyken de çalışması gerektiği anlamına geliyor.

Oyunlar daha özgür, çünkü eğlencenin kendisi duruş olabilir. Yine de bir yedek seçenek sunmak işe yarar. Örneğin Marbles Unhinged, App Store'da ekranda menteşesi olan herhangi bir iPhone veya iPad'de de oynanabildiğini belirtiyor.

Hangi oyunlar menteşeyi bir kontrole dönüştürüyor?

Birçok iPhone Duo oyunu katlama hareketini şimdiden bir girdi olarak kullanıyor. Aşağıdaki açıklamalar her oyunun App Store sayfasından ve basında çıkan haberlerden alındı. Her geliştiricinin dahili olarak hangi API'leri kullandığını bilmiyoruz.

Bunlar API'lerle güzelce eşleşiyor. Toastie'nin kapağı .closed durumuna bir geçiş. Marbles Unhinged'in rampası sürekli bir açı. Greens ve Battlefleet Duo, üst yarının bir görünüm gösterdiği ve alt yarının dokunmaları aldığı masa üstü düzenleri. Duometry ham açıya ihtiyaç duyuyor.

Katlama hareketini kullanan daha fazla oyunu Built for the Fold sayfasında inceleyebilirsiniz.

Önemli çıkarımlar

• iPhone Duo üç menteşe durumu (closed, partiallyOpen ve fullyOpen) ve sürekli bir açı bildirir. UIKit'te ayrıca unknown var.
• SwiftUI'de .onHingeChange, UIKit'te UIHingeInteraction kullanın. İkisi de iOS 27.1 ile geldi ve menteşe yoksa ikisi de nil bir hinge verir.
• SwiftUI closure'ı eski ve yeni bağlamları alır; böylece her açı güncellemesi yerine geçişlere tepki verebilirsiniz.
• Düzeni boyut sınıflarına, sistem kapsayıcılarına, ArrangementView'a ve ayrılmış bölgelere bırakın. Menteşe verisini efektler, etkileşimler ve oyun mekanikleri için kullanın.
• Masa üstü tasarımları medyayı üste, kontrolleri tabana koymalı; diğer duruşlarda hiçbir özelliği gizlememeli.

Sırada, kontrolleri kıvrımdan nasıl uzak tutacağınızı ayrılmış bölgeler rehberimizde öğrenin ya da yukarıdaki oyunları Built for the Fold sayfasından oynayın.