Skip to Content
dAppsMobile et liens profonds
Sur cette page

Mobile et liens profonds

Ouvrez OneKey depuis une dApp mobile avec un URI d’association WalletConnect. Un lien profond ouvre l’application du portefeuille ; la connexion n’aboutit qu’après l’approbation de la session WalletConnect par l’utilisateur.

Vue d’ensemble

Créez un nouvel URI d’association avec votre intégration WalletConnect, puis ouvrez l’un des liens ci-dessous à partir d’une action utilisateur. Maintenez la proposition de session active et attendez son approbation ou son rejet. Dans le navigateur de dApps OneKey, utilisez plutôt le fournisseur injecté pour la chaîne cible.

Schéma personnalisé

onekey-wallet://wc?uri={encodeURIComponent(wcUri)}
https://app.onekey.so/wc/connect/wc?uri={encodeURIComponent(wcUri)}

Testez l’ouverture de l’application et le mécanisme de repli sur les versions iOS/Android et les navigateurs pris en charge. L’installation de l’application, les paramètres de liens du système d’exploitation et les restrictions des navigateurs intégrés influent sur le résultat.

Exemple d’utilisation

// Generate WalletConnect URI from your dApp
const wcUri = 'wc:a281...' // Your WalletConnect URI
 
// Option 1: Custom scheme
const customSchemeLink = `onekey-wallet://wc?uri=${encodeURIComponent(wcUri)}`
 
// Option 2: Universal link (recommended)
const universalLink = `https://app.onekey.so/wc/connect/wc?uri=${encodeURIComponent(wcUri)}`
 
// Call this from the user's Connect button.
function openOneKey() {
  window.location.href = universalLink
}

Gestion de la connexion et du repli

  • Ouvrez le lien depuis un bouton de connexion explicite. Certains navigateurs bloquent le lancement d’applications sans action de l’utilisateur.
  • Gérez les événements d’approbation, de rejet, d’expiration et de déconnexion de session WalletConnect. Le simple retour au navigateur ne prouve pas qu’une session a été approuvée.
  • Proposez un QR code sur ordinateur et une option d’installation ou de nouvelle tentative si l’ouverture de l’application échoue. Ne supposez pas qu’un lien universel redirige toujours vers une boutique d’applications.
  • Générez un nouvel URI d’association lorsque le précédent expire. N’incluez pas d’URI d’association actif dans les outils d’analyse ou les journaux de l’application.
  • Privilégiez le parcours mobile de votre bibliothèque de connexion de portefeuilles lorsqu’il est disponible ; il gère l’association et le cycle de vie des sessions.
Dernière mise à jour le
GuideVue d’ensemble