家庭影院

家庭影院

本项目基于 Quectel Pi H1 智能主控板开发，以 Kodi 开源媒体中心软件为核心，构建了一套集媒体播放、库管理、多场景适配于一体的家庭影院系统。该项目实现本地与网络媒体资源的一站式整合与高清播放，充分满足家庭影音娱乐的多样化需求，为用户提供高品质的家庭娱乐体验。

  • 案例描述
  • 资源准备
  • 快速上手
  • 进阶使用

本项目基于 Quectel Pi H1 智能主控板开发，以 Kodi 开源媒体中心软件为核心，构建了一套集媒体播放、库管理、多场景适配于一体的家庭影院系统。该项目实现本地与网络媒体资源的一站式整合与高清播放，充分满足家庭影音娱乐的多样化需求，为用户提供高品质的家庭娱乐体验。

开发配件清单

开发配件只是作为参考，不同的开发环境可能会有所差异，比如通过ssh远程连接进行开发，可以不使用usb拓展板，显示屏也可以根据需要进行替换。

配件名称 数量 规格参数
Quectel Pi H1 智能主控板 1块 Quectel Pi H1智能主控板
电源适配器 1个 27W USB Type-C接口充电器 1.2米线长中规电源PD电源 适用于树莓派5代
HDMI 线 1根 规格：HDMI 2.0；线长：1m；接口：HDMI-A（公头）-HDMI-D（公头）
网线 1根 线长：1m；传输速率：千兆
CPU 散热风扇 1个 树莓派5代官方原装散热器带导热贴
显示屏 1个 24 英寸 HDMI 显示器

配件实物参考

开发准备

Quectel Pi H1 智能主控板出厂默认搭载 Debian 13 系统镜像，因此无需再次烧录镜像，仅需按照如下步骤操作即可。

硬件连接

散热风扇安装

先将散热风扇的排线插入智能主控板的 FAN 插槽中，然后将散热器上的两端固定在智能主控板预留的插孔中，如下：

显示连接

将 HDMI 线一端接入智能主控板的 HDMI 接口，另一端接入显示器的 HDMI 接口。

image-20251017144027933

输入设备连接

将 USB 键盘、鼠标接入智能主控板的两个 USB-A 接口上，若用无线输入设备，将接收器插入 USB 接口即可。

image-20251017144124363

网络连接

将网线一端接入智能主控板的千兆网口，另一端接入路由器的网口（确保路由器已联网）。

跳线帽连接

智能主控板左上角标有AUTO_POWER_ON丝印的排针，确保已经用跳线帽短接。

image-20251017144330473

供电连接

将 USB-A 电源线的 USB-A 端接入电源适配器，USB-C 端接入智能主控板的电源口（通常标注 POWER IN ）。

image-20251017172353513

连接完成参考

image-20251211175705335

项目实现

  • 更新安装源

sudo apt update

  • 安装 Kodi 服务

sudo apt install kodi

  • 安装PVR插件

sudo apt install kodi-pvr-iptvsimple

  • 确保在 Kodi 启动期间视频加速API能正确初始化。要将用户添加到组中，请使用以下命令：

sudo usermod -a -G cdrom,audio,render,video,plugdev,users,dialout,dip,input username
例：sudo usermod -a -G cdrom,audio,render,video,plugdev,users,dialout,dip,input pi

  • 确保运行 Kodi 的用户属于以下组（例如，对于用户pi）

groups username

  • 重新启动后，在登录界面右下角齿轮中选择?" Kodi on GBM "?运行 Kodi 服务。

image-20251211100841075

进入 Kodi 后，系统会提示是否启用已安装的插件，此时可选择 NO，出现 Enter add-on browser 和 Remove this main menu item 的选项，点击左上方的齿轮进入设置。

  • Kodi 中文设置

进入设置后，选择Interface→Skin→Fonts更换字体为Arial based。选择Regional→Language→Chinese(Simple)。

image-20251211114708337

  • 添加插件

为了方便操作，我们可以使用"\"对 Kodi 进行全屏和窗口切换。

我们在终端安装时就已经通过命令安装过 IPTV Simple Client ，所以我们点击设置→插件→我的插件→PVR 客户端就可以看得到 IPTV Simple Client ，点击进入设置。

  • 添加源

?位置默认是远程路径，可以通过点右边上下切换标志切换到本地路径，在M3U播放列表路径中选择直播源文件目录（直播源文件一般为M3U8，可在网上搜索下载存放到本地或者通过URL远程路径访问）。这里选择远程路径加载直播源，将远程URL输入?"M3U播放列表URL栏"?即可，点击确定后启用该配置，按下ESC回退到导航界面。

?image-20251211114546616

  • 进入设置->播放器点击齿轮切换到专家模式，允许使用DRM PRIME解码器并选择EGL渲染。

image-20251211114759152

  • 按下ESC回到主界面，点击电视栏，选择自己喜欢的节目，就可以进行观看了。

image-20251211150859728?

image-20251211114608223?

image-20251211114855880

注：目前只能播放较低帧率的电视节目，硬件视频解码还在适配中，更多信息请及时关注移远开发者官网。

下面介绍如何导入电影、视频等资源在 Kodi 上实现播放。

第一步：在Movies界面下点击 Enter files section -> Add videos 添加资源。

image-20260108150326469

第二步：选择导入资源存放的路径然后点击OK（示例路径为 /home/pi/media )。

image-20260108151433505

第三步：设置资源类型为 Movies ，其他选项默认即可，然后点击 OK 会提示是否更新信息，选择 "Yes" 即可，Kodi 会自动扫描文件夹里的视频，从网上下载封面、简介等信息。等扫描完成后，回到 "Movies" 界面，就能看到带封面的电影了。

image-20260108152104330?

image-20260108154716354

注：上述操作是在导入视频的信息能与网上资源匹配的情况下，若无法匹配则不能加载到 "Movies" 界面。

接下来介绍导入自定义资源的方法。

第一步：点击Movies界面进入视频存放文件夹，将光标移至目标视频并右键单击，然后选择 Scan to library。

image-20260108165512090

第二步：输入电影名，这里需要修改成能与网上资源匹配的名称，如：build.mp4。

image-20260108165912545

第三步：信息匹配后会弹出提示框，选择 "Yes" 即可，然后双击选择任意一个匹配的影片，再按下ESC回退到 "Movies" 界面，这时我们能看到没有加载出封面的自定义影片。

image-20260108170530793

第四步：退出系统再重新登陆加载资源。

image-20260108170755721

第五步：点击Movies界面，在自定义影片上右键选择Manage，在这里可以修改电影名称、类型分类等；点击Choose art->Poster，选择已存放在导入文件夹下的图片更改视频封面。

image-20260108171144920?

image-20260108171352946

第六步：按下Esc回到初始界面，然后在视频上右键选择Mark as Watched，最后返回 "Movies" 界面，就能看到更换封面后的自定义影片了。

image-20260108171917615?

image-20260108172228223

沟通无界，服务无限

了解更多关于移远公司、产品和技术支持的信息。

更多详情
sitemap、地图