SJVideoPlayer 使用指南

SJVideoPlayer 使用指南

SJBaseVideoPlayer video player. rotation, volume, brightness, rate, play, pause, stop, seekToTime, present. 项目地址: https://gitcode.com/gh_mirrors/sj/SJBaseVideoPlayer

---

安装指南

SJVideoPlayer 是一个用于 iOS 的视频播放器框架，可以通过 CocoaPods 进行简单安装。

步骤 1: 打开终端，进入您的项目目录。 步骤 2: 在 Podfile 中添加以下行：

pod 'SJVideoPlayer'

步骤 3: 运行 pod install 命令来安装依赖并更新项目。

项目配置旋转

为了使视频播放时能够正确处理设备旋转，需要按照以下四个步骤配置您的项目：

1. 修改应用程序支持的方向：

   • 进入项目设置 (Targets -> General)，在 Device Orientation 下仅选择 Portrait 方向。

2. 在 AppDelegate 中集成旋转管理：

   • 导入 SJRotationManager 头文件，并重写 application:supportedInterfaceOrientationsForWindow: 方法。

   #import "SJRotationManager.h"
   
   @implementation AppDelegate
   - (UIInterfaceOrientationMask)application:(UIApplication *)application supportedInterfaceOrientationsForWindow:(UIWindow *)window {
       return [SJRotationManager supportedInterfaceOrientationsForWindow:window];
   }
   

   对于 Swift，代码略有不同。

3. 配置 UIViewController 及其容器类的旋转行为： 将提供的 Objective-C 分类代码复制到您的项目中的任意位置，以统一管理 autorotate 行为。

4. 对于 iOS 13+，确保您的播放视图控制器不自动旋转： 在您的播放视图控制器中覆写 shouldAutorotate 并返回 NO，同时适配生命周期方法以通知播放器视图控制器状态变化。

快速开始

1. 导入 SJVideoPlayer 头文件：

   #import <SJVideoPlayer/SJVideoPlayer.h>
   

2. 创建 player 属性： 在您的视图控制器中声明并初始化 SJVideoPlayer 实例。

3. 布局 player 视图： 在 viewDidLoad 方法中设置 SJVideoPlayer 的视图，并进行约束布局。

4. 设置播放源并开始播放： 使用 SJVideoPlayerURLAsset 初始化播放资源，并设置给播放器。

示例代码如下：

- (void)viewDidLoad {
    [super viewDidLoad];
    _player = SJVideoPlayer.player;
    [self.view addSubview:_player.view];
    // 设置约束 ...
    SJVideoPlayerURLAsset *asset = [SJVideoPlayerURLAsset.alloc initWithURL:yourMediaURL];
    _player.URLAsset = asset;
}

API 使用文档

具体的 API 文档详细信息请参考 GitHub 项目的 Wiki 页面，那里提供了更全面的方法、属性以及使用案例。

---

以上就是 SJVideoPlayer 的基本安装、配置和快速使用的流程。通过遵循这些步骤，您可以轻松地在您的应用中集成视频播放功能。如果有进一步的技术疑问，可通过作者提供的联系方式获取支持。记得在适当的时候给予项目一些反馈或赞助，以鼓励开源社区的发展。

SJBaseVideoPlayer video player. rotation, volume, brightness, rate, play, pause, stop, seekToTime, present. 项目地址: https://gitcode.com/gh_mirrors/sj/SJBaseVideoPlayer