flutter::AndroidExternalViewEmbedder Class Reference

#include <external_view_embedder.h>

Inheritance diagram for flutter::AndroidExternalViewEmbedder:

Public Member Functions
	AndroidExternalViewEmbedder (const AndroidContext &android_context, std::shared_ptr< PlatformViewAndroidJNI > jni_facade, std::shared_ptr< AndroidSurfaceFactory > surface_factory, const TaskRunners &task_runners)
void	PrerollCompositeEmbeddedView (int64_t view_id, std::unique_ptr< flutter::EmbeddedViewParams > params) override
DlCanvas *	CompositeEmbeddedView (int64_t view_id) override
void	SubmitFlutterView (int64_t flutter_view_id, GrDirectContext *context, const std::shared_ptr< impeller::AiksContext > &aiks_context, std::unique_ptr< SurfaceFrame > frame) override
PostPrerollResult	PostPrerollAction (const fml::RefPtr< fml::RasterThreadMerger > &raster_thread_merger) override
DlCanvas *	GetRootCanvas () override
void	BeginFrame (GrDirectContext *context, const fml::RefPtr< fml::RasterThreadMerger > &raster_thread_merger) override
void	PrepareFlutterView (DlISize frame_size, double device_pixel_ratio) override
void	CancelFrame () override
void	EndFrame (bool should_resubmit_frame, const fml::RefPtr< fml::RasterThreadMerger > &raster_thread_merger) override
bool	SupportsDynamicThreadMerging () override
void	Teardown () override
DlRect	GetViewRect (int64_t view_id) const
Public Member Functions inherited from flutter::ExternalViewEmbedder
	ExternalViewEmbedder ()=default
virtual	~ExternalViewEmbedder ()=default
virtual void	CollectView (int64_t view_id)
virtual void	PrerollCompositeEmbeddedView (int64_t platform_view_id, std::unique_ptr< EmbeddedViewParams > params)=0
void	SetUsedThisFrame (bool used_this_frame)
bool	GetUsedThisFrame () const
virtual void	PushVisitedPlatformView (int64_t platform_view_id)
virtual void	PushFilterToVisitedPlatformViews (const std::shared_ptr< DlImageFilter > &filter, const DlRect &filter_rect)

Detailed Description

Allows to embed Android views into a Flutter application.

This class calls Java methods via |PlatformViewAndroidJNI| to manage the lifecycle of the Android view corresponding to |flutter::PlatformViewLayer|.

It also orchestrates overlay surfaces. These are Android views that render above (by Z order) the Android view corresponding to |flutter::PlatformViewLayer|.

Definition at line 29 of file external_view_embedder.h.

Constructor & Destructor Documentation

AndroidExternalViewEmbedder()

flutter::AndroidExternalViewEmbedder::AndroidExternalViewEmbedder	(	const AndroidContext &	android_context,
		std::shared_ptr< PlatformViewAndroidJNI >	jni_facade,
		std::shared_ptr< AndroidSurfaceFactory >	surface_factory,
		const TaskRunners &	task_runners
	)

Definition at line 13 of file external_view_embedder.cc.

    : ExternalViewEmbedder(),
      android_context_(android_context),
      jni_facade_(std::move(jni_facade)),
      surface_factory_(std::move(surface_factory)),
      surface_pool_(
          std::make_unique<SurfacePool>(/*use_new_surface_methods=*/false)),
      task_runners_(task_runners) {}

Member Function Documentation

BeginFrame()

void flutter::AndroidExternalViewEmbedder::BeginFrame ( GrDirectContext *  context, const fml::RefPtr< fml::RasterThreadMerger > &  raster_thread_merger  )

overridevirtual

Implements flutter::ExternalViewEmbedder.

Definition at line 207 of file external_view_embedder.cc.

                                                                  {
  // JNI method must be called on the platform thread.
  if (raster_thread_merger->IsOnPlatformThread()) {
    jni_facade_->FlutterViewBeginFrame();
  }
}

CancelFrame()

void flutter::AndroidExternalViewEmbedder::CancelFrame ( )

overridevirtual

Implements flutter::ExternalViewEmbedder.

Definition at line 234 of file external_view_embedder.cc.

                                              {
  Reset();
}

Referenced by PostPrerollAction().

CompositeEmbeddedView()

DlCanvas * flutter::AndroidExternalViewEmbedder::CompositeEmbeddedView ( int64_t  view_id )

overridevirtual

Implements flutter::ExternalViewEmbedder.

Definition at line 48 of file external_view_embedder.cc.

                                                                            {
  if (slices_.count(view_id) == 1) {
    return slices_.at(view_id)->canvas();
  }
  return nullptr;
}

References view_id.

EndFrame()

void flutter::AndroidExternalViewEmbedder::EndFrame ( bool  should_resubmit_frame, const fml::RefPtr< fml::RasterThreadMerger > &  raster_thread_merger  )

overridevirtual

Reimplemented from flutter::ExternalViewEmbedder.

Definition at line 239 of file external_view_embedder.cc.

                                                                  {
  surface_pool_->RecycleLayers();
  // JNI method must be called on the platform thread.
  if (raster_thread_merger->IsOnPlatformThread()) {
    jni_facade_->FlutterViewEndFrame();
  }
}

GetRootCanvas()

DlCanvas * flutter::AndroidExternalViewEmbedder::GetRootCanvas ( )

overridevirtual

Implements flutter::ExternalViewEmbedder.

Definition at line 194 of file external_view_embedder.cc.

                                                     {
  // On Android, the root surface is created from the on-screen render target.
  return nullptr;
}

GetViewRect()

DlRect flutter::AndroidExternalViewEmbedder::GetViewRect

(

int64_t

view_id

)

const

Definition at line 55 of file external_view_embedder.cc.

                                                                     {
  const EmbeddedViewParams& params = view_params_.at(view_id);
  // TODO(egarciad): The rect should be computed from the mutator stack.
  // (Clipping is missing)
  // https://github.com/flutter/flutter/issues/59821
  return params.finalBoundingRect();
}

References params, and view_id.

Referenced by SubmitFlutterView().

PostPrerollAction()

PostPrerollResult flutter::AndroidExternalViewEmbedder::PostPrerollAction ( const fml::RefPtr< fml::RasterThreadMerger > &  raster_thread_merger )

overridevirtual

Reimplemented from flutter::ExternalViewEmbedder.

Definition at line 162 of file external_view_embedder.cc.

                                                                  {
  if (!FrameHasPlatformLayers()) {
    return PostPrerollResult::kSuccess;
  }
  if (!raster_thread_merger->IsMerged()) {
    // The raster thread merger may be disabled if the rasterizer is being
    // created or teared down.
    //
    // In such cases, the current frame is dropped, and a new frame is attempted
    // with the same layer tree.
    //
    // Eventually, the frame is submitted once this method returns `kSuccess`.
    // At that point, the raster tasks are handled on the platform thread.
    CancelFrame();
    raster_thread_merger->MergeWithLease(kDefaultMergedLeaseDuration);
    return PostPrerollResult::kSkipAndRetryFrame;
  }
  raster_thread_merger->ExtendLeaseTo(kDefaultMergedLeaseDuration);
  // Surface switch requires to resubmit the frame.
  // TODO(egarciad): https://github.com/flutter/flutter/issues/65652
  if (previous_frame_view_count_ == 0) {
    return PostPrerollResult::kResubmitFrame;
  }
  return PostPrerollResult::kSuccess;
}

References CancelFrame(), flutter::kResubmitFrame, flutter::kSkipAndRetryFrame, and flutter::kSuccess.

PrepareFlutterView()

void flutter::AndroidExternalViewEmbedder::PrepareFlutterView ( DlISize  frame_size, double  device_pixel_ratio  )

overridevirtual

Implements flutter::ExternalViewEmbedder.

Definition at line 217 of file external_view_embedder.cc.

                               {
  Reset();
 
  // The surface size changed. Therefore, destroy existing surfaces as
  // the existing surfaces in the pool can't be recycled.
  if (frame_size_ != frame_size) {
    DestroySurfaces();
  }
  surface_pool_->SetFrameSize(frame_size);
 
  frame_size_ = frame_size;
  device_pixel_ratio_ = device_pixel_ratio;
}

PrerollCompositeEmbeddedView()

void flutter::AndroidExternalViewEmbedder::PrerollCompositeEmbeddedView ( int64_t  view_id, std::unique_ptr< flutter::EmbeddedViewParams >  params  )

override

Definition at line 27 of file external_view_embedder.cc.

                                              {
  TRACE_EVENT0("flutter",
               "AndroidExternalViewEmbedder::PrerollCompositeEmbeddedView");
 
  DlRect view_bounds = DlRect::MakeSize(frame_size_);
  std::unique_ptr<EmbedderViewSlice> view;
  view = std::make_unique<DisplayListEmbedderViewSlice>(view_bounds);
  slices_.insert_or_assign(view_id, std::move(view));
 
  composition_order_.push_back(view_id);
  // Update params only if they changed.
  if (view_params_.count(view_id) == 1 &&
      view_params_.at(view_id) == *params.get()) {
    return;
  }
  view_params_.insert_or_assign(view_id, EmbeddedViewParams(*params.get()));
}

References impeller::TRect< Scalar >::MakeSize(), params, TRACE_EVENT0, view, and view_id.

SubmitFlutterView()

void flutter::AndroidExternalViewEmbedder::SubmitFlutterView ( int64_t  flutter_view_id, GrDirectContext *  context, const std::shared_ptr< impeller::AiksContext > &  aiks_context, std::unique_ptr< SurfaceFrame >  frame  )

overridevirtual

Reimplemented from flutter::ExternalViewEmbedder.

Definition at line 64 of file external_view_embedder.cc.

                                       {
  TRACE_EVENT0("flutter", "AndroidExternalViewEmbedder::SubmitFlutterView");
  // TODO(dkwingsmt): This class only supports rendering into the implicit view.
  // Properly support multi-view in the future.
  FML_DCHECK(flutter_view_id == kFlutterImplicitViewId);
 
  if (!FrameHasPlatformLayers()) {
    frame->Submit();
    return;
  }
 
  std::unordered_map<int64_t, DlRect> view_rects;
  for (auto platform_id : composition_order_) {
    view_rects[platform_id] = GetViewRect(platform_id);
  }
 
  std::unordered_map<int64_t, DlRect> overlay_layers =
      SliceViews(frame->Canvas(),     //
                 composition_order_,  //
                 slices_,             //
                 view_rects           //
      );
 
  // Submit the background canvas frame before switching the GL context to
  // the overlay surfaces.
  //
  // Skip a frame if the embedding is switching surfaces, and indicate in
  // `PostPrerollAction` that this frame must be resubmitted.
  auto should_submit_current_frame = previous_frame_view_count_ > 0;
  if (should_submit_current_frame) {
    frame->Submit();
  }
 
  for (int64_t view_id : composition_order_) {
    DlRect view_rect = GetViewRect(view_id);
    const EmbeddedViewParams& params = view_params_.at(view_id);
    // Display the platform view. If it's already displayed, then it's
    // just positioned and sized.
    jni_facade_->FlutterViewOnDisplayPlatformView(
        view_id,                //
        view_rect.GetX(),       //
        view_rect.GetY(),       //
        view_rect.GetWidth(),   //
        view_rect.GetHeight(),  //
        params.sizePoints().width * device_pixel_ratio_,
        params.sizePoints().height * device_pixel_ratio_,
        params.mutatorsStack()  //
    );
    std::unordered_map<int64_t, DlRect>::const_iterator overlay =
        overlay_layers.find(view_id);
    if (overlay == overlay_layers.end()) {
      continue;
    }
    std::unique_ptr<SurfaceFrame> frame =
        CreateSurfaceIfNeeded(context,                    //
                              view_id,                    //
                              slices_.at(view_id).get(),  //
                              overlay->second             //
        );
    if (should_submit_current_frame) {
      frame->Submit();
    }
  }
}

References FML_DCHECK, impeller::TRect< T >::GetHeight(), GetViewRect(), impeller::TRect< T >::GetWidth(), impeller::TRect< T >::GetX(), impeller::TRect< T >::GetY(), flutter::kFlutterImplicitViewId, params, flutter::SliceViews(), TRACE_EVENT0, and view_id.

SupportsDynamicThreadMerging()

bool flutter::AndroidExternalViewEmbedder::SupportsDynamicThreadMerging ( )

overridevirtual

Reimplemented from flutter::ExternalViewEmbedder.

Definition at line 250 of file external_view_embedder.cc.

                                                               {
  return true;
}

Teardown()

void flutter::AndroidExternalViewEmbedder::Teardown ( )

overridevirtual

Reimplemented from flutter::ExternalViewEmbedder.

Definition at line 255 of file external_view_embedder.cc.

                                           {
  DestroySurfaces();
}

---

The documentation for this class was generated from the following files:

• shell/platform/android/external_view_embedder/external_view_embedder.h
• shell/platform/android/external_view_embedder/external_view_embedder.cc