メインコンテンツへスキップ

noteのiOSアプリへのメッセージ機能搭載がんばったよの話

    noteでアプリ開発を担当している小林です。

    noteにはクリエイター同士でやりとりが行えるメッセージ機能があり、先日のアップデートでメッセージの引用返信やリアクションをつけられるようになりました。

    画像
    メッセージに返信やリアクションができるようになりました!

    LINEやMessengerのようなコミュニケーションアプリでは定番の機能ではありますが、いざ同じように作ってみようと思うとけっこう大変だったりします。今回は、実際に作ってみて特にiOSおよびSwiftUIで再現が難しかったところを紹介したいと思います。

    iOSにはそもそもBottom to Topスクロールがない

    メッセージ機能は通常、最下部に最新のメッセージが表示され、上にスクロールすると過去のメッセージが閲覧できる仕様です。スクロールの原点が画面の一番下で、かつ下から上にかけてメッセージをスタックされるようなUI構造が作れると、自然と再現できるはずです。しかし残念ながらiOSにはこのようなUI構造をつくる仕組みは用意されていないため、従来からある左上起点の座標系とスクロールで再現する必要があります。

    画像
    おわかりいただけただろうか

    UIKitベースであれば、メッセージの全長計算やスクロール位置の補正を命令的に行うことで再現できなくもないですが、SwiftUIベースだとさらに難しくなります。

    下記のコードは画面下から上に向かってメッセージを表示するために作成したカスタムスクロールビューの一部です。anchorToBottomがtrueのとき、データ読み込み等で表示するメッセージ内容が増えると、画面下に張り付いたように振る舞います。
    (実際は親View/ViewModel側で細かい制御をしています)

    /// 逆スクロールに対応するスクロールビュー
    struct BottomToTopScrollView<Content: View>: View {
        ...
    
        init(
            anchorToBottom: Binding<Bool>,
            @ViewBuilder content: @escaping (ScrollViewProxy) -> Content
        ) { ... }
    
        var body: some View {
            ScrollViewReader { proxy in
                ScrollView {
                    content(proxy)
                }
            }
            .onScrollGeometryChange(for: ScrollGeometry.self) { geometry in
                geometry
            } action: { oldValue, newValue in
                guard anchorToBottom else { return }
    
                if newValue.contentSize.height > oldValue.contentSize.height {
                    // 追加読み込み後の要素積み上げによるスクロールのずれを補正
                    scrollPosition.scrollTo(
                        y: (oldValue.contentOffset.y + oldValue.contentInsets.top) + (newValue.contentSize.height - oldValue.contentSize.height)
                    )
                }
            }
            .scrollPosition($scrollPosition)
        }
    

    カスタムコンテキストメニューの実装

    リアクション機能の追加においては、SwiftUIデフォルトのコンテキストメニューではカスタムのビューが表示できないため、独自実装しようと判断しました。このコンテキストメニューの独自実装もいろいろと考慮が必要なので注意が必要です。例えば、

    • メニューはメッセージ付近の上または下に表示させる

    • 対象メッセージのハイライト表現

    • 対象メッセージが長文など、画面の支配領域が大きいときのメニュー表示方法

    などについてどこまで考慮するか、デザイン要件とのバランスを取る必要があります。

    カスタムメニュー実現のための設計

    今回カスタムメニューを作るために、2つのView Modifierを用意しました。

    • contextOverlayTarget(): カスタムメニューの表示対象となるメッセージセルに付与するマーカー

    • contextOverlay(): カスタムメニューの表示内容。メニュー表示を行う親ビュー側に付与

    contextOverlayTarget()はこんな感じで、メニュー表示対象のメッセージに付与し、長押しジェスチャーの検出と、anchorPreference()を使ってその矩形領域や関連データの紐付けをします。

    // contextOverlayTarget()の本体
    struct ContextOverlayTargetModifier<Item: Identifiable>: ViewModifier where Item.ID: Hashable & Sendable {
        @Environment(\.contextOverlayFocus) private var focusOverlayTarget
        ...
    
        func body(content: Content) -> some View {
            let anyID = AnyHashable(item.id)
            content
                .simultaneousGesture(
                    LongPressGesture(minimumDuration: 0.25).onEnded { _ in
                        // このitemに対するcontextOverlay()を展開
                        focusOverlayTarget?(anyID)
                    }
                )
                .anchorPreference(key: ContextOverlayTargetKey.self, value: .bounds) { anchor in
                    [anyID: ContextOverlayTargetInfo(
                        id: anyID,
                        anchor: anchor,
                        horizontalEdge: horizontalEdge,
                        payload: item
                    )]
                }
        }
    }
    
    // メッセージセル(抜粋)
    struct MessageCell: View {
        ...
    
        var body: some View {
            // メッセージ本体以外の装飾などは省略...
            // メッセージ本文部分
            content()
                .contextOverlayTarget(
                    item: MessageRoomContextOverlayItem.message(message),
                    horizontalEdge: message.isMyMessage ? .trailing : .leading
                )
        }
    }

    これに対しcontextOverlay()はこんな感じで、画面全体をdimmingし、カスタムメニューやメッセージのハイライトを適切な位置に表示します。

    // contextOverlay()の本体
    struct ContextOverlayModifier<Item: Identifiable, ItemContent: View, Controls: View>: ViewModifier where Item.ID: Hashable & Sendable {
        ...
    
        func body(content: Content) -> some View {
            content
                .environment(\.contextOverlayFocusedID, focusedID.map(AnyHashable.init))
                .environment(\.contextOverlayFocus) { targetID in
                    focusedID = targetID.base as? Item.ID
                }
                .sensoryFeedback(.selection, trigger: focusedID) { _, focusedID in
                    focusedID != nil
                }
                .overlayPreferenceValue(ContextOverlayTargetKey.self) { infos in
                    GeometryReader { proxy in
                        Color.clear
                            // dimming
                            .overlay { ... }
                            // content
                            .overlay(alignment: .topLeading) {
                                if let selectedID,
                                   let info = infos[selectedID],
                                   let item = info.payload as? Item
                                {
                                    overlayContent(...)
                                        .transition(.opacity)
                                }
                            }
                            .animation(.smooth(duration: 0.25), value: focusedID)
                    }
                }
        }
    
        @ViewBuilder
        private func overlayContent(...) -> some View { ... }
    }
    
    // メッセージ画面(抜粋)
    struct MessageRoomView: View {
        ...
    
        var body: some View {
            ...
                .contextOverlay(
                    for: MessageRoomContextOverlayItem.self,
                    focusedID: $focusedItemID,
                    preferredWidth: 320,
                    // ハイライトメッセージのUI
                    itemContent: { item in ... },
                    // メニュー部分のUI
                    controls: { item, edge in ... }
                )
            ...
        }
    }

    本当はOS標準コンテキストメニューのように、ナビゲーションエリアを含めたさらに上のレイヤでオーバレイしたいのですが、より実装が複雑になりそうだったのでやっていません。

    対象メッセージに対し、メニューをどこに表示するか?

    メッセージが画面上のどこにあって、どれくらいかの大きさにより、表示の仕方を3パターンに分けています。

    • メッセージが画面の上寄りにある: メッセージの下にメニューを表示

    • メッセージが画面の下寄りにある: メッセージより上にメニューを表示

    • メッセージが長文等で高さがある: メッセージ中央に重ねてメニューを表示
      (メニューが画面内に収まらない場合の考慮。このときメッセージのハイライトは出さない)

    struct ContextOverlayModifier ... {
        ...
    
        // メニューをどこへどのように表示するか判断
        private func popupPlacement(
            itemRect: CGRect,
            horizontalEdge: HorizontalEdge,
            in screenSize: CGSize
        ) -> PopupPlacement {
            let showsItemContent = ... // itemRect.heightが大きくなければtrue
            let showsItemBelow = ... // itemRect.midYが画面中央より上ならtrue
    
            let alignment: Alignment = switch (showsItemBelow, horizontalEdge) {
            case (true, .leading): .topLeading
            case (true, .trailing): .topTrailing
            case (false, .leading): .bottomLeading
            case (false, .trailing): .bottomTrailing
            }
    
            ...
    
            if showsItemContent {
                if showsItemBelow {
                    // メッセージの下にメニューを表示
                    return PopupPlacement(
                        containerRect: ..., // カスタムメニューを展開する矩形領域
                        alignment: alignment,
                        controlsEdge: .bottom,
                        showsItemContent: true
                    )
                } else {
                    // メッセージの上にメニューを表示
                    return PopupPlacement(
                        containerRect: ...,
                        alignment: alignment,
                        controlsEdge: .top,
                        showsItemContent: true
                    )
                }
            } else {
                // メッセージの中央にメニューを表示
                return PopupPlacement(
                    containerRect: ...,
                    alignment: alignment,
                    controlsEdge: showsItemBelow ? .bottom : .top,
                    showsItemContent: false
                )
            }
        }
    }

    対象メッセージをハイライトする

    contextOverlay()は画面全体に半透明の黒をかけてdimmingし、その上にカスタムメニューをレイアウトしています。ただこのままだと、対象メッセージもdimmingがかかってしまいます。今回はメッセージの吹き出し部分だけを「重ね描き」する方法で、ハイライトしたように見せています。

    struct ContextOverlayModifier ... {
        let itemContent: (Item) -> ItemContent
        let controls: (Item, Edge) -> Controls
        ...
    
        // カスタムメニューとメッセージの重ね描き
        @ViewBuilder
        private func overlayContent(
            item: Item,
            itemRect: CGRect,
            horizontalEdge: HorizontalEdge,
            screenSize: CGSize
        ) -> some View {
            let placement = popupPlacement(
                itemRect: itemRect,
                horizontalEdge: horizontalEdge,
                in: screenSize
            )
    
            ZStack(alignment: .topLeading) {
                if placement.showsItemContent {
                    // targetにしたメッセージと同じ位置に重ね描き
                    itemContent(item)
                        .shadow(radius: 20)
                        .frame(width: itemRect.width, height: itemRect.height, alignment: .center)
                        .position(x: itemRect.midX, y: itemRect.midY)
                        .zIndex(2)
                }
                // placementで算出した位置にメニューを表示
                Color.clear
                    .overlay(alignment: placement.alignment) {
                        controls(item, placement.controlsEdge)
                            .frame(
                                width: placement.containerRect.width,
                                alignment: horizontalEdge == .leading ? .leading : .trailing
                            )
                            .shadow(radius: 20)
                    }
                    .frame(
                        width: placement.containerRect.width,
                        height: placement.containerRect.height
                    )
                    .offset(
                        x: placement.containerRect.minX,
                        y: placement.containerRect.minY
                    )
                    .zIndex(3)
            }
        }
    }

    AIでもある程度は再現可能、ただし調整は必要

    これらの機能開発でもClaude CodeやCodexにはかなりお世話になりましたが、すべての問題が解決できたわけではありませんでした。まずプロトタイプの作成をAIにさせ、ある程度実現の見通しがたったところで、細かいケースへの対応を行なっていきました。その過程ではAIの生成したコードでは考慮しきれてない場合もあり、自分のアイディアをAIに提案しながら、最終的な形にしました。

    画像
    プロトタイプ作成の様子。AIと対話しながら完成度を上げていく

    事前の準備とAIにかなり助けられましたが、より多くのケースを考慮しているLINEやMessengerはやっぱすげぇな!というのが、今回やってみた感想です。

    noteではエンジニアを募集しております!
    noteに興味ある方、お待ちしております。


     
     
    モバイルアプリ(iOS)エンジニア@note 最近はIT/プログラミング教育にも携わっております。 ほかにも子育てにまつわる話も投稿しています。 料理、野菜作りが趣味。JRPGと弾幕STGが好き。

    あなたへのおすすめ