AndroidScreenCaster 使用与安装指南

AndroidScreenCaster 使用与安装指南

1. 项目目录结构及介绍

AndroidScreenCaster 是一个高效的低延迟屏幕镜像解决方案，支持通过H.264和WebM编码在Android设备上进行实时屏幕投屏，采用TCP和UDP协议。以下是其主要的目录结构概述：

• app: 主应用模块，包含了服务和UI相关的代码。

  • src/main/java: 存放Java源代码。
    • com/github/magicsih/androidscreencaster/service: 包含了ScreenCastService.java等，这是核心服务实现，处理屏幕捕捉和编码逻辑。
  • src/main/res: 应用资源文件，如布局文件和图片。
  • 其他常规 Gradle 配置文件如build.gradle, AndroidManifest.xml等。

• consts: 常量定义，包括活动和服务间通信的消息常量(ActivityServiceMessage)以及意图传递的额外数据(ExtraIntent)。

• datagram: 数据报套接字客户端相关类，用于UDP传输。

• tcpstream: TCP流相关客户端类，负责TCP连接的管理。

• writer: 视频帧写入器，如IvfWriter，用于视频流的处理。

• gradle.properties, build.gradle(项目级), build.gradle(模块级): 构建系统配置文件。

• gitignore, LICENSE, README.md: 分别是Git忽略文件、软件许可协议和项目说明文档。

2. 项目的启动文件介绍

项目的主要启动和交互逻辑集中在app/src/main/java/com/github/magicsih/androidscreencaster/service/ScreenCastService.java这个服务类中。这个服务是整个应用的心脏，它负责初始化媒体投影(MediaProjection)来获取屏幕图像，然后通过编码（可能是H.264或WebM）并将这些编码后的视频流发送到远程接收端。服务的启动通常不是直接由用户操作，而是通过应用内部的活动或者接收特定的广播触发。

3. 项目的配置文件介绍

主要配置文件

• build.gradle (Module: app): 这个文件定义了应用模块的构建依赖项、编译版本、以及其他构建设置。对于开发者来说，这里是添加库依赖、调整编译参数的关键位置。

• AndroidManifest.xml: 定义了应用程序的基本元数据，包括所需的权限（比如访问显示和投屏），服务和活动的声明，以及应用的默认主题等。对于本项目，特别关注的是<service>标签，其中声明了ScreenCastService。

• gradle.properties: 包含全局的Gradle构建属性，例如版本号和一些环境变量设定，虽然不直接影响应用运行逻辑，但对于构建过程非常重要。

• 其他配置: 项目中的配置主要是通过上述文件进行，没有单独的配置文件如同.yaml或.properties形式的传统配置文件。所有关于编码参数、网络配置等逻辑通常内嵌于Java源码之中，尤其是在服务和相关客户端类中直接进行设定。

综上所述，AndroidScreenCaster的开发和配置紧密地绑定在Java源代码和Gradle构建脚本中，理解这些源文件对部署和自定义该应用至关重要。在实际使用时，开发者需重点阅读ScreenCastService的服务实现，并正确配置 Gradle 文件以适应不同的构建需求。