概要

HarmonyOS-Inno は、ArkTS/ArkUI を前提とした HarmonyOS アプリ／ゲーム向けの「OHBridge」イノベーション能力集合 SDK のサンプル実装リポジトリです。主にデバイス固有の機能（近距離シェア／隔空シェア、画像のアルバム保存、方向センサー、短震動、端末上での TTS、アプリ内ページ遷移、マーケット評価誘導ダイアログ、AgentKit によるスマートエージェントパネル表示など）を JavaScript/TypeScript から呼べるようブリッジ層でまとめています。実行環境や OS バージョンの判定（例: deviceInfo.majorVersion >= 6）や canIUse による機能可否チェックを行うことで、互換性のある実装を提供しています。

リポジトリの統計情報

スター数: 11
フォーク数: 2
ウォッチャー数: 11
コミット数: 4
ファイル数: 7
メインの言語: TypeScript

主な特徴

ArkTS/ArkUI アプリ向けにデバイス固有機能を統合した OHBridge API 提供
HarmonyOS バージョンや能力の実行時判定（deviceInfo.majorVersion / canIUse）
シェア（近接／隔空）や画像アルバム保存、TTS、センサー、振動など豊富なユーティリティ
ブリッジ層によりネイティブ機能へ安全にアクセスできるサンプル構成

技術的なポイント

OHBridge はクライアント（ArkTS）側からネイティブ機能を呼び出すためのラッパー層を備え、実行時の能力判定とフォールバックを重視した設計になっています。README にある通り、隔空シェア（gesturesShare）は HarmonyOS 6.0 以上でのみ動作するため、deviceInfo.majorVersion >= 6 のチェックを行い、API 呼び出し前に canIUse で機能可否を確認します。これにより古い OS での不具合やクラッシュを未然に防げます。

TypeScript を用いた型付き実装により、呼び出し側はメソッドのシグネチャを把握しやすく、Promise ベースやコールバックの扱いを統一することで非同期処理が明確になります。ブリッジフォルダ（bridge ディレクトリ）にネイティブ連携コードがまとめられており、プラットフォーム固有の処理（権限リクエスト、ファイル I/O、センサー購読、TTS セッション管理、AgentKit 管理など）を分離することで保守性を高めています。

センサー系は方向センサーのリスニングを行い、購読・解除 API を提供することで UI とセンサーイベントの結合度を下げます。アルバム保存はスクリーンショットや画像データの保存処理をラップし、必要なストレージ権限のチェックとユーザー許諾フローを統合します。シェア機能は「碰一碰分享（近接共有）」と「隔空分享（gesturesShare）」を扱い、添付データ（画像／URL）やモードの違いを抽象化します。

AgentKit の表示/非表示制御やアプリ内評価ダイアログなどは、システムが提供するサービスやストア API との連携を想定しており、呼び出し失敗時のフォールバック処理（ユーザーに案内する UI など）も実装パターンとして用意されています。全体として、機能検出 → 権限確認 → 実行 → 結果ハンドリングのフローが一貫しており、実運用での安全性とユーザー体験を両立しています。（約700字）

プロジェクトの構成

主要なファイルとディレクトリ：

.gitattributes: file
COCOS_README.MD: file
LICENSE: file
README.MD: file
bridge: dir

…他 2 ファイル

まとめ

ArkTS ベースの HarmonyOS 向け機能ラッパー実装として実用的で、OS 判定や権限処理に配慮された良質なサンプル集です。（約50字）

リポジトリ情報：

名前: HarmonyOS-Inno
説明: HarmonyOS Next innovative capabilities case repo.
スター数: 11
言語: TypeScript
URL: https://github.com/iwae/HarmonyOS-Inno
オーナー: iwae
アバター: https://avatars.githubusercontent.com/u/26038745?v=4

READMEの抜粋：

HarmonyOS 创新能力集合 SDK 使用文档（OHBridge）

本文档面向使用 ArkTS/ArkUI 的 HarmonyOS 应用/游戏开发者，介绍 OHBridge（创新能力集合 SDK）的集成方式与能力使用，包括：

分享能力：碰一碰分享 / 隔空分享（图片 / 超链接）
相册保存：保存截图到系统相册
传感器：方向传感器监听
震动：短震反馈
TTS：端侧语音朗读/停止
应用内跳转：页面路由打开
评论弹窗：应用市场评价引导
AgentKit：展示/隐藏智能体面板（如接入 AgentKitManager）

1. 运行环境与依赖

1.1 HarmonyOS 版本要求

隔空分享 gesturesShare：要求 HarmonyOS 6.0+（代码中通过 deviceInfo.majorVersion >= 6 判断）
其余能力根据系统能力判断（canIUse(...)），例如传感器、应用市场服务等

HarmonyOS-Inno — HarmonyOS 次世代イノベーション機能集 SDK