跳到主要内容
版本:v7

使用插件 API

在实现屏幕方向功能之前,先构建一个能够调用插件 API 的用户界面是合理的做法。本质上,我们想要搭建一个测试框架,以便快速测试跨平台的功能一致性。

本教程的重点是如何构建 Capacitor 插件,而不是如何构建 Ionic Framework 应用,因此你可以直接获取所需文件的完成版本,并将其内容复制粘贴到你的项目中:

复制完成后,使用 ionic serve 命令启动 Capacitor 应用。打开浏览器的开发者工具,你应该会看到以下错误:

Uncaught (in promise) ScreenOrientation does not have web implementation.

这个错误是合理的;我们还没有为任何平台实现代码。保持浏览器打开状态,我们将首先实现 Web 平台。在此之前,让我们回顾一下 Home.tsx 中的相关代码。

插件是如何被使用的?

跟踪屏幕方向:

const [orientation, setOrientation] = useState<string>('');

orientation 状态变量用于存储屏幕方向的值,可以通过调用 setOrientation 来更新。由于代码开始执行时我们不知道当前的屏幕方向,因此默认设置为空字符串。使用字符串类型是为了更方便地告知 UI 要显示哪种设计。

建立了一个事件监听器,当 screenOrientationChange 被触发时更新 orientation

ScreenOrientation.addListener('screenOrientationChange', res =>
setOrientation(res.type),
);

UI 加载时会获取当前屏幕方向,并且当 UI 从 DOM 中移除时,会移除所有创建的监听器(例如上面的监听器)。

useEffect(() => {
ScreenOrientation.orientation().then(res => setOrientation(res.type));

return () => {
ScreenOrientation.removeAllListeners();
};
}, []);

请不要过于纠结 useEffect 和返回函数;这些是 React 特定的语法规则。

显示正确的设计:

OrientationType 有两个纵向方向的值:portrait-primaryportrait-secondary。横向方向也是如此。我们的 UI 不关心它们之间的区别,只关心是横向还是纵向。

{
orientation.includes('portrait') &&
{
/* 提供一个按钮,用于旋转屏幕方向并将其锁定为横向模式。 */
};
}
{
orientation.includes('landscape') &&
{
/* 让用户通过确认按钮“签名”并解锁屏幕方向。 */
};
}

锁定和解锁屏幕方向:

纵向设计包含一个按钮,按下时将更改屏幕方向并锁定它。

onClick={() => ScreenOrientation.lock({ orientation: "landscape-primary" })}

相反,横向设计包含一个按钮,按下时将解锁屏幕方向。

onClick={() => ScreenOrientation.unlock()}

Home.tsxHome.css 中的其余代码纯粹是装饰性的;我们不需要深入探讨。运行 npm run build,以便在 iOS 或 Android 上运行应用时使用新的 UI。

现在我们有了一个能够调用插件 API 的用户界面,让我们开始实现功能吧!下一步我们将首先针对 Web 平台:实现 Web 版本。