🐣

Telegram Mini Apps の React SDK を v3 に上げたらフルスクリーンが効かなくなって困った

に公開
Next.js
React
TypeScript
SDK
teregram
tech

前提

  • Teregram Mini Apps環境
  • 「リッチメッセージ／リッチシェア」 は Telegram Bot API の savePreparedInlineMessage を指す
  • 記載の不具合は2025/06/30時点の観測結果で、以降のアップデートで解消されている場合がある

起きたこと

v3 のリッチシェアを使うためにReact SDK を v2→v3 にアップグレードした。
目的だったリッチシェアは React SDK v3 で利用できた。
しかし、v2で機能していたフルスクリーンがv3では機能しなくなった。

フルスクリーンモード
Doc：https://docs.telegram-mini-apps.com/platform/viewport#fullscreen

リッチシェア
Doc：https://core.telegram.org/bots/api#savepreparedinlinemessage

解決策

Core SDKと React SDK を併用して解決した（暫定対応）

補足

  • Core SDKではフルスクリーンが動作することがわかった
  • フルスクリーンは Core SDK v3、リッチシェアは React SDK v3 を使用した
  • 公式ドキュメントによると併用は推奨されていないが、同じメソッドを Core SDK と React SDK から重複して呼び出さなければ問題なさそう
  • Core SDK の使用は最小限にし、React SDK の修正パッチ後に React SDK へ戻す予定
機能 React v2 React v3 Core v2 Core v3
フルスクリーン ○ ×（※） ○ ○
リッチシェア × ○ × ○

※メソッドは提供されているが（多分）バグで機能しない

Discussion