Phi シリカ アドオンの作成

このガイドでは、Electron アプリで Phi Silica AI API を呼び出す C# ネイティブ アドオンを作成する方法について説明します。 Phi Silica は、NPU (ニューラル処理ユニット) を使用Windows 11デバイス上でローカルに実行される小さな言語モデルです。

[前提条件]

このガイドを開始する前に、次の作業が完了していることを確認してください。

• 開発環境のセットアップが完了しました
• Copilot+ PC - Phi Silica には NPU (ニューラル処理装置) を備えたデバイスが必要です

手順 1: C# ネイティブ アドオンを作成する

次に、エキサイティングな部分として、Windows API を呼び出すネイティブ アドオンを作成しましょう。 node-api-dotnet を利用して JavaScript と C# をブリッジする C# テンプレートを使用します。

npx winapp node create-addon --template cs

これにより、次の csAddon/ フォルダーが作成されます。

• addon.cs - Windows API を呼び出す C# コード
• csAddon.csproj - Windows SDK と Windows アプリ SDK への参照を含むProject ファイル
• README.md - アドオンの使用方法に関するドキュメント

また、このコマンドは、アドオンをビルドするためのbuild-csAddon スクリプトと、ビルド成果物をクリーニングするためのpackage.json スクリプトをclean-csAddonに追加します。

{
  "scripts": {
    "build-csAddon": "dotnet publish ./csAddon/csAddon.csproj -c Release",
    "clean-csAddon": "dotnet clean ./csAddon/csAddon.csproj"
  }
}

テンプレートには両方の SDK への参照が自動的に含まれるため、Windows API の呼び出しをすぐに開始できます。

アドオンをビルドして、すべてが正しく設定されていることを確認しましょう。

# Build the C# addon
npm run build-csAddon

手順 2: Phi Silica を使用して AI 機能を追加する

実際のWindows アプリ SDK API を追加しましょう。Phi Silica AI モデルを使用して、デバイス上でテキストを直接集計します。

csAddon/addon.csを開き、次のコードを追加します。

using System;
using System.Threading.Tasks;
using Microsoft.JavaScript.NodeApi;
using Microsoft.Windows.AI;
using Microsoft.Windows.AI.Text;

namespace csAddon
{
    [JSExport]
    public class Addon
    {
        /// <summary>
        /// Summarizes the provided text using the Phi Silica AI model.
        /// </summary>
        /// <param name="text">The text to summarize</param>
        /// <returns>A summary of the input text</returns>
        [JSExport]
        public static async Task<string> SummarizeText(string text)
        {
            try
            {
                var readyState = LanguageModel.GetReadyState();
                if (readyState is AIFeatureReadyState.Ready or AIFeatureReadyState.NotReady)
                {
                    if (readyState == AIFeatureReadyState.NotReady)
                    {
                        await LanguageModel.EnsureReadyAsync();
                    }

                    using LanguageModel languageModel = await LanguageModel.CreateAsync();
                    TextSummarizer textSummarizer = new TextSummarizer(languageModel);

                    var result = await textSummarizer.SummarizeParagraphAsync(text);

                    return result.Text;
                }

                return "Model is not available";
            }
            catch (Exception ex)
            {
                return $"Error calling Phi Silica API: {ex.Message}";
            }
        }
    }
}

手順 3: C# アドオンをビルドする

次に、アドオンをもう一度ビルドします。

npm run build-csAddon

これにより、 ネイティブ AOT (Ahead-of-Time コンパイル) を使用して C# コードがコンパイルされます。これは次のとおりです。

• .node バイナリ (ネイティブ アドオン形式) を作成します。
• 未使用のコードをトリミングしてバンドル サイズを小さくする
• ターゲット マシンに.NETランタイムは必要ありません。
• ネイティブ パフォーマンスを提供します

コンパイルされたアドオンは csAddon/dist/csAddon.node。

手順 4: Windows API をテストする

次に、メイン プロセスからアドオンを呼び出して、アドオンが機能することを確認しましょう。 src/main.jsを開き、次の手順に従います。

4.1。 C# アドオンを読み込む

これを、ファイルの先頭にある他の require ステートメントと共に追加します。

const csAddon = require('../csAddon/dist/csAddon.node');

4.2. テスト関数を作成する

この関数をファイル内のどこかに追加します (require ステートメントの後)。

const callPhiSilica = async () => {
  console.log('Summarizing with Phi Silica: ')
  const result = await csAddon.Addon.summarizeText("The Windows App Development CLI is a powerful tool that bridges cross-platform development with Windows-native capabilities.");
  console.log('Summary:', result);
};

4.3. 関数を呼び出す

アプリの起動時に API をテストするには、 createWindow() 関数の末尾に次の行を追加します。

callPhiSilica();

アプリを実行すると、概要がコンソールに出力されます。 ここから、アドオンをアプリに統合することができますが、必要に応じて、レンダラー プロセスへの事前読み込みスクリプトを使用してアドインを公開するか、IPC ハンドラーから呼び出すか、メイン プロセスで直接使用するかを指定します。

手順 5: 必要な機能を追加する

Phi Silica API を使用する前に、アプリ マニフェストで必要な機能を宣言する必要があります。 Package.appxmanifestを開き、systemAIModels セクション内に<Capabilities>機能を追加します。

<Capabilities>
  <rescap:Capability Name="runFullTrust" />
  <rescap:Capability Name="systemAIModels" />
</Capabilities>

手順 6: デバッグ ID を更新する

マニフェストで参照されている Package.appxmanifest を変更したり、アセット (アプリ アイコンなど) を変更したりするたびに、アプリのデバッグ ID を更新する必要があります。 走れ

npx winapp node add-electron-debug-identity

このコマンド:

1. Package.appxmanifestを読み取り、アプリの詳細と機能を取得します
2. electron.exe内でnode_modulesを一時的な ID で登録します
3. 完全な MSIX パッケージ化なしで ID が必要な API をテストできます

次に、アプリを実行します。

npm start

コンソールの出力を確認します。Phi Silica の概要が印刷されています。

次のステップ

おめでとうございます! これで、WINDOWS AI API を呼び出すネイティブ アドオンが正常に作成されました。 🎉

これで、次の準備ができました。

• 配布用にアプリをパッケージ化 する - 配布できる MSIX パッケージを作成する

または、他のガイドを調べる:

• WinML アドオンの作成 - Windows Machine Learningの使用方法について説明します
• 概要 - メイン ガイドに戻る

その他のリソース

• winapp CLI のドキュメント - 完全な CLI リファレンス
• サンプル Electron アプリ - 完全な作業例
• Windows electron - Windows AI Addon for Electron は、JavaScript から直接 Windows AI API にアクセスできる Node.js ネイティブ アドオンです。
• AI 開発ギャラリー - すべての AI API のサンプル ギャラリー
• Windows アプリ SDK Samples - Windows アプリ SDK サンプルのコレクション
• node-api-dotnet - C# ↔ JavaScript 相互運用ライブラリ