QDesktopServices Class

メンバー関数ドキュメント

[static] bool QDesktopServices::openUrl(const QUrl &url)

ユーザーのデスクトップ環境に適したウェブブラウザで、与えられたurl を開き、成功した場合はtrue を返し、そうでない場合はfalse を返す。

URLがローカルファイルへの参照（すなわち、URLスキームが「file」）である場合、Webブラウザーの代わりに適切なアプリケーションで開かれる。

以下の例では、スペースを含むパスに存在するWindowsファイルシステム上のファイルを開いている：

QDesktopServices::openUrl(QUrl("file:///C:/Program Files", QUrl::TolerantMode));

mailto URLが指定された場合、ユーザーの電子メールクライアントは、mailto リンクがWebブラウザによって処理される方法と同様に、URLで指定されたオプションを含むコンポーザーウィンドウを開くために使われる。

たとえば、次の URL には受信者（user@foo.com ）、件名（Test ）、メッセージ本文（Just a test ）が含まれています：

mailto:user@foo.com?subject=Test&body=Just a test

<key>LSApplicationQueriesSchemes</key>
<array>
    <string>https</string>
</array>

setUrlHandler()も参照してください 。

[static] void QDesktopServices::setUrlHandler(const QString &scheme, QObject *receiver, const char *method)

与えられたscheme のハンドラを、receiver オブジェクトが提供するハンドラmethod に設定する。

この関数は、openUrl （）の動作をカスタマイズする方法を提供する。scheme が指定された URL でopenUrl() が呼び出された場合、QDesktopServices が外部アプリケーションを起動する代わりに、receiver オブジェクトの指定されたmethod が呼び出されます。

提供されるメソッドは、単一の引数QUrl のみを受け付けるスロットとして実装する必要があります。

class MyHelpHandler : public QObject
{
    Q_OBJECT
public:
    // ...
public slots:
    void showHelp(const QUrl &url);
};

setUrlHandler()が、すでにハンドラを持つスキームに新しいハンドラを設定するために使用される場合、既存のハンドラは単に新しいハンドラに置き換えられます。QDesktopServices はハンドラの所有権を持たないため、ハンドラが置き換えられてもオブジェクトは削除されません。

ハンドラは常に、QDesktopServices::openUrl() を呼び出したのと同じスレッド内から呼び出されることに注意してください。

ハンドラ・オブジェクトを破棄する前にunsetUrlHandler() を呼び出す必要があるため、ハンドラ・オブジェクトの破棄と、それを使用したopenUrl() の同時呼び出しが重なることはない。

iOSとmacOS

iOS/macOSで他のアプリからデータを受信するためにこの関数を使用するには、Info.plistファイルのCFBundleURLSchemes リストにカスタムスキームを追加する必要があります：

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>myapp</string>
        </array>
    </dict>
</array>

詳細については、Apple Developer Documentation forDefining a Custom URL Scheme for Your Appを参照してください。

Info.plistファイル内の上記のエントリは、httpとhttpsのサポートを要求することはできません。これは、Entitlementsファイルにドメインを追加した場合にのみ可能です：

<key>com.apple.developer.associated-domains</key>
<array>
    <string>applinks:your.domain.com</string>
</array>

iOS/macOSは、アプリケーションがインストールされると、あなたのドメインで/.well-known/apple-app-site-associationを検索します。https://your.domain.com/help?topic=ABCDEF を聞きたい場合は、そこに以下の内容を記述する必要があります：

{
    "applinks": {
        "apps": [],
        "details": [{
            "appIDs" : [ "ABCDE12345.com.example.app" ],
            "components": [{
                "/": "/help",
                "?": { "topic": "?*"}
            }]
        }]
    }
}

詳細については、Apple Developer Documentation forSupporting Associated Domainsを参照してください。

アンドロイド

Android で他のアプリからデータを受信するためにこの機能を使用するには、アプリマニフェストのactivity に 1 つ以上のインテント フィルタを追加する必要があります：

<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="https" android:host="your.domain.com" android:port="1337" android:path="/help"/>
</intent-filter>

詳細については、Android Developer Documentation forCreate Deep Links to App Contentを参照してください。

ユーザーがアプリを選択しなくても、Android アプリで対応するコンテンツをすぐに開くには、リンクを検証する必要があります。検証を有効にするには、インテント・フィルタに追加のパラメータを追加します：

<intent-filter android:autoVerify="true">

アプリケーションがインストールされると、Android はhttps://your.domain.com/.well-known/assetlinks.json を探します。https://your.domain.com:1337/help を聴きたい場合は、次のコンテンツを提供する必要があります：

[{
  "relation": ["delegate_permission/common.handle_all_urls"],
  "target": {
    "namespace": "android_app",
    "package_name": "com.example.app",
    "sha256_cert_fingerprints":
    ["14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5"]
  }
}]

詳細については、Android Developer Documentation forVerify Android App Linksを参照してください。

openUrl() およびunsetUrlHandler()も参照して ください。

[static] void QDesktopServices::unsetUrlHandler(const QString &scheme)

指定されたscheme に対して以前に設定された URL ハンドラを削除する。

この関数は、scheme に登録されていたハンドラオブジェクトが破棄される前に呼び出すことで、openUrl() の同時呼び出しによって破棄されたハンドラオブジェクトが引き続き呼び出されることを防ぐ。

setUrlHandler()も参照 。