Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

[bug] iOS: `useiOSBroadcastExtension: false` ignored since 2.4.0, in-app capture unreachable

オープン
  • 何か問題がありますか？
#1,150 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
55/100
issue の種類
バグ
明瞭さ
明確に書かれている
活発さ
静か
技術スタック
dart, flutter, ios
領域
mobile

調査の方向性

Start in lib/src/participant/local.dart and trace how the effective ScreenShareCaptureOptions are chosen before the iOS broadcast branch; then read ios/Classes/BroadcastManager.swift to understand the missing-extension guard. Done means useiOSBroadcastExtension: false reaches in-app capture, while a requested broadcast flow without an extension reports an error rather than silently returning success. Check for existing screen-share tests before adding coverage.

索引モデルが issue の本文から書いたものです。

説明

Describe the bug

Since 2.4.0, setScreenShareEnabled(true) on iOS unconditionally routes into the Broadcast Upload Extension flow. ScreenShareCaptureOptions.useiOSBroadcastExtension still exists, but false (the documented in-app RPScreenRecorder mode through 2.3.6) has no effect.

lib/src/participant/local.dart (2.4.0–2.10.0 and current main):

if (lkPlatformIs(PlatformType.iOS) && !BroadcastManager().isBroadcasting) {
  // Wait until broadcasting to publish track
  await BroadcastManager().requestActivation();
  return null;
}

The branch precedes any capture options inspection; the in-app path below it is unreachable.

Worse, without an extension: requestActivation()'s native side (ios/Classes/BroadcastManager.swift) guard-returns when the RTCScreenSharingExtension Info.plist key is absent:

func requestActivation() {
    guard let bundleIdentifier = BroadcastBundleInfo.screenSharingExtension else { return }
    Task { await Self.showPicker(for: bundleIdentifier) }
}

No picker, no consent UI, no error, and no log so the call resolves null as success.

This appears to be an unintended side effect of #705 ("fix: Properly handle broadcast capture state"): the PR documents its async-return breaking change but never mentions useiOSBroadcastExtension or the in-app path. That capturer still works in flutter_webrtc, reachable via LocalVideoTrack.createScreenShareTrack() + publishVideoTrack() which is our current workaround.

Broadcast extension capture is always whole screen; in-app capture is scoped to the app's own UI. For privacy sensitive products (share this app with a support agent, never the user's other apps or notifications), app scoped capture is impossible through the public screenshare API on every released version.

To Reproduce

  1. Flutter app on a physical iPhone, livekit_client ≥ 2.4.0, no Broadcast Upload Extension target.
  2. Connect to a room, then: 
    await room.localParticipant!.setScreenShareEnabled(
  true,
  screenShareCaptureOptions:
      const ScreenShareCaptureOptions(useiOSBroadcastExtension: false),
);
  3. The call resolves (null); no consent UI, no published track, nothing logged. Remote participants receive nothing.
  4. On 2.3.6 the same code shows the ReplayKit consent alert and publishes an in-app screenshare track.

Expected behavior

  • useiOSBroadcastExtension: false (explicit or via RoomOptions.defaultScreenShareCaptureOptions) uses the in-app capturer, as through 2.3.6 . The gate should consult the effective capture options before routing to BroadcastManager.
  • Independently: when the broadcast flow is requested but RTCScreenSharingExtension is missing, fail loudly (throw or error event) instead of a silent null. Currently misconfiguration looks like success.

Platform information

  • Flutter version: 3.44.2
  • Plugin version: reproduced on 2.7.0 and 2.10.0 ; unchanged on main, 2026-08-04
  • Flutter target OS: iOS (real device, iPhone 17)
  • Flutter target OS version: iOS 26.4
  • Flutter console log: n/a, failure produces no output
主要言語
Dart
スター
421
フォーク
260
平均マージ
2日 5時間
マージ済み PR（30日）
17

環境構築

このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

livekit/client-sdk-flutter のほかの issue

livekit/client-sdk-flutter の issue をすべて見る

似ている issue

Dart の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。