ガイド一覧
取り組んでいるタスクを選んでください
以下の各要約は、それだけで疑問に答えられる分量にしてあります。ページを開く前に、これから 20 分を使う価値があるかどうかを判断できます。
Delphi から LLM を呼び出す
VCL、FMX、コンソールのいずれのアプリケーションからでもプロンプトを送信し、OpenAI や Anthropic Claude のようなホスト型モデル、あるいは Ollama 経由で自分のマシン上で動くモデルから回答を受け取ります。経路は 2 つあります。TsgcAIChat はすべてのプロバイダーを 1 つの API の背後にまとめるため、ベンダーの変更は Provider への代入 1 行で済みます。ベンダー別クライアントの TsgcHTTP_API_OpenAI、TsgcHTTP_API_Anthropic、TsgcHTTP_API_Ollama は各ベンダー API をすべて公開しており、画像入力、バッチ、埋め込み、文字起こしが必要な場合に使えます。
続いてページは、どのプロジェクトでも次にぶつかる 3 つの事柄を扱います。1 つ目はストリーミングで、モデルがまだ生成している間にテキストがメモ欄へ現れるようにします。デコード済みデルタのレベルと生イベントのレベルの両方を示します。2 つ目はツール呼び出しで、Pascal の関数を JSON Schema として記述し、モデルがその実行を依頼してきます。3 つ目はホスト型モデルとローカルモデルの選択で、データ処理契約の対象となるものについては、これは性能ではなくコンプライアンスの判断になります。
必要なもの：sgcWebSockets Enterprise、または単体パッケージの sgcAI です。REST クライアントは Windows、macOS、Linux、iOS、Android でコンパイルできます。TsgcAIChat は Windows 専用のため、ページでは両方の経路を示しています。
ガイドを読む →
OAuth2 と PKCE でユーザーをサインインさせる
PKCE 付き認可コードフローは、今日どのプロバイダーもネイティブデスクトップアプリケーションに求めるフローです。これを非ビジュアルコンポーネント 1 つで実行します。埋め込みブラウザーも、自前の Web サーバーも、REST フレームワークも不要です。TsgcHTTP_OAuth2_Client が verifier を生成し、challenge を導出し、システムブラウザーを開き、ループバックリダイレクトを待ち受け、コードを交換し、トークンとともに OnAfterAccessToken を発火させます。
デスクトップでこのフローが崩れる場所はリダイレクトです。そのためページは相応の紙幅をここに割きます。なぜリダイレクト先が公開 URL ではなくループバックアドレスなのか、プロバイダーに何を登録するのか、そして redirect_uri_mismatch が何を示しているのかを扱います。続いて、ブラウザーを二度と開かせないためのリフレッシュトークン、資格情報を放置せずに保管する方法、すぐに使える Google と Microsoft 向けコンポーネント、さらに Gmail と Microsoft 365 が現在 SMTP と IMAP で要求する XOAUTH2 の受け渡しを説明します。
必要なもの：sgcWebSockets Standard 以上、または単体パッケージの sgcAuth です。Windows、macOS、Linux、iOS、Android に対応します。Enterprise 限定なのは認可サーバー側の機能だけです。
ガイドを読む →
2 つの Delphi アプリケーションを WebRTC で接続する
異なるネットワーク上にある 2 つのアプリケーションが、チャットチャネル、マイクのストリーム、カメラのストリームを互いに直接やり取りします。間にメディアサーバーはなく、プロセスにブラウザーを埋め込むこともありません。ページは WebRTC を実際に構成する 4 つの問題に分解します。セッションを SDP のオファーとアンサーとして記述すること、その記述を相手側へ届けること、NAT を越える経路を見つけること、そして実際にバイトを流すことです。
シグナリングは自分で書く部分なので、TsgcWebSocketServer 上で 3 種類のメッセージを中継するだけの単純なリレーとして、完全な形で掲載しています。続いてピア接続とそのイベント、ICE 候補、そして host、server reflexive、relay の各候補にかかるコスト、忘れられがちな TURN のスイッチ、チャネル単位で信頼性を設定できる SCTP データチャネル、そして音声トラックと映像トラックを扱います。トラックはデータチャネルとは異なるトランスポートであり、失敗の仕方も異なります。締めくくりは、エラーをまったく出さない失敗についてです。ピアツーピアのデバッグが難しいのはこれが理由です。
必要なもの：ピア接続、ICE クライアント、TURN クライアントは sgcWebSockets Enterprise に含まれます。オファーとアンサーのメソッド、データチャネル、メディアトラックには、Enterprise に加えて sgcWebRTC パックが必要です。どちらも All-Access に含まれています。STUN クライアントは Standard から利用できます。
ガイドを読む →