패키지 상세v1.0.3

vimeo_video_player

비메오 비디오 ID를 사용하여 비디오를 재생하는 플러터 패키지입니다. InAppWebView를 활용하여 플러터 앱 내에서 원활한 비디오 재생을 제공합니다.

AndroidiOSWebmacOSWindows

pub.dev API 문서 소스 코드

30일 다운로드: 1.1만
좋아요: 81
Pub 점수: 140

패키지 설치

flutter pub add vimeo_video_player

패키지 개요

공개 정보를 바탕으로 생성한 선택 가이드입니다.

vimeo_video_player 패키지는 동영상 ID를 사용하여 Flutter 애플리케이션 내에서 Vimeo 동영상을 원활하게 재생할 수 있도록 합니다. InAppWebView 기반으로 구축되어 Android, iOS, 웹, macOS, Windows에서 부드러운 임베디드 비디오 경험을 제공합니다. 인증 및 스트리밍 로직을 내부적으로 처리함으로써 통합을 간소화하여 개발자가 UI와 사용자 경험에 집중할 수 있도록 합니다. 반응형 디자인을 지원하며 웹 뷰 인터페이스를 통해 기본 재생 컨트롤을 제공합니다.

사용 사례

모바일 앱에 Vimeo 비디오 삽입
교육용 앱에서 비디오 콘텐츠 통합
전자상거래 앱에서 제품 데모 표시
스트리밍 튜토리얼 또는 교육 비디오
앱 인터페이스에 비디오 배경 추가하기

주요 기능

비디오 ID를 통해 Vimeo 비디오 재생
신뢰성 있는 재생을 위해 InAppWebView 사용
크로스 플랫폼 지원 (Android, iOS, Web, macOS, Windows)
최소 설정으로 간단한 통합
반응형 비디오 렌더링
웹 뷰를 통한 내장 재생 제어

적합한 대상

미디어가 풍부한 Flutter 앱을 개발하는 개발자
교육 또는 튜토리얼 중심의 애플리케이션
비디오 콘텐츠를 갖춘 전자상거래 플랫폼
Vimeo에서 임베드된 비디오가 필요한 앱

고려 사항

InAppWebView에 의존하며, 저사양 기기에서 성능에 영향을 줄 수 있습니다
비디오 스트리밍을 위해서는 인터넷 연결이 필요합니다
웹 뷰 외의 플레이어 UI 사용자 정의는 제한적
일부 플랫폼에서는 추가 권한이 필요할 수 있습니다
Vimeo API의 가용성 및 안정성에 따라 달라짐

원본 README

연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.

vimeo_video_player

A Flutter package to play Vimeo videos using their Video ID. Utilizes InAppWebView for smooth video playback directly in your Flutter app.

Key Features

Easy way to play vimeo video in flutter app.
Supports customizable controls like isAutoPlay, isLooping, isMuted, showTitle, showByline, showControls, enableDNT, backgroundColor.
Event callbacks include onReady, onPlay, onPause, onFinish, onSeek, onInAppWebViewCreated, onInAppWebViewLoadStart, onInAppWebViewLoadStop, and onInAppWebViewReceivedError.

Preview

Basic Usage

Import it to your project file

import 'package:vimeo_video_player/vimeo_video_player.dart';

And add it in its most basic form like it:

@override
Widget build(BuildContext context) {
  return VimeoVideoPlayer(
    videoId: '12860646',
  );
}

Required parameters of VimeoVideoPlayer

Parameter	Description
String videoId	Defines the vimeo video ID to be played, it is required and cannot be empty

Optional parameters of VimeoVideoPlayer with Default value

Parameter	Default	Description
bool isAutoPlay	false	Used to auto-play the video once initialized
bool isLooping	false	Used to play the video in a loop after it ends
bool isMuted	false	Used to play the video with the sound muted
bool showTitle	false	Used to display the video title
bool showByline	false	Used to display the video byline/author
bool showControls	true	Used to display the video playback controls
bool enableDNT	true	Used to enable Do Not Track (DNT) mode, When enabled, the player will not track any viewing information
bool portrait	false	Used to display the profile avatar
bool badge	false	Used to display the vimeo logo
bool enableFullScreenOnPlay	false	Used to enable fullscreen mode when playing. When enabled, the player go full screen when play is hit
Color backgroundColor	Colors.black	Defines the background color of the InAppWebView

Optional parameters of VimeoVideoPlayer

Parameter	Description
String? privacyHash	Used to define the the hash for the unlisted vimeo video
VoidCallback? onReady	Used to define a callback function triggered when the player is ready to play the video
VoidCallback? onPlay	Used to define a callback function triggered when the video begins playing
VoidCallback? onPause	Used to define a callback function triggered when the video is paused
VoidCallback? onFinish	Used to define a callback function triggered when the video playback finishes
VoidCallback? onSeek	Used to define a callback function triggered when the video playback position is modified
Function(InAppWebViewController controller)? onInAppWebViewCreated	Used to define a callback function triggered when the WebView is created
Function(InAppWebViewController controller, WebUri? uri)? onInAppWebViewLoadStart	Used to define a callback function triggered when the WebView starts to load an url
Function(InAppWebViewController controller, WebUri? uri)? onInAppWebViewLoadStop	Used to define a callback function triggered when the WebView finishes loading an url
Function(InAppWebViewController controller, WebResourceRequest request, WebResourceError? error)? onInAppWebViewReceivedError	Used to define a callback function triggered when the WebView encounters an error loading a request
final void Function(InAppWebViewController controller)? onEnterFullscreen	Used to define a callback function triggered when the WebView enters full screen
final void Function(InAppWebViewController controller)? onExitFullscreen	Used to define a callback function triggered when the WebView exits full screen
final ValueChanged? currentPositionInSeconds	Used to define a callback function that notifies current video position
int? initialPositionInSeconds	Used to define the initial video position in seconds

Dependencies

flutter_inappwebview: ^6.1.5

Guideline for contributors

Contribution towards our repository is always welcome, we request contributors to create a pull request for development.

Guideline to report an issue/feature request

It would be great for us if the reporter can share the below things to understand the root cause of the issue.

Library version
Code snippet
Logs if applicable
Device specification like (Manufacturer, OS version, etc)
Screenshot/video with steps to reproduce the issue
Library used

LICENSE!

vimeo_video_player is MIT-licensed.

Let us know!

We’d be really happy if you send us links to your projects where you use our open-source libraries. Just send an email to [sales@mindinventory.com](mailto:sales@mindinventory.com) And do let us know if you have any questions or suggestion regarding our work.

Visit our website mindinventory.com

Let us know if you are interested to building Apps or Designing Products.