Todos los productos
Search
Centro de documentos

Cloud Phone:Pegar texto en Safari con el Web SDK

Última actualización: Sep 05, 2026

Debido a las restricciones de seguridad, Safari muestra una ventana emergente nativa al acceder al portapapeles. Esto afecta la experiencia del usuario cuando se sincroniza contenido hacia el Cloud Phone. En este tema se explica cómo usar el Web SDK para pegar texto del portapapeles local en Safari.

Descripción general de la solución

  1. Agregue un botón de portapapeles personalizado a su cliente local. Al hacer clic en este botón, se abre un cuadro de entrada emergente.

  2. Introduzca en el cuadro de entrada emergente el contenido que desea enviar al Cloud Phone.

  3. Haga clic en el botón Paste Now del cuadro de entrada emergente para sincronizar el contenido con el portapapeles y el campo de entrada del Cloud Phone.

Procedimiento

Parámetros del Cloud Phone

  • Establezca readClipboardDataByUser en true para evitar que el SDK lea automáticamente el portapapeles.

  • Establezca useCustomIme en true para habilitar el editor de método de entrada (IME) local. Este paso es obligatorio para sincronizar el contenido con el campo de entrada del Cloud Phone.

// Check if the browser is Safari.
function isSafari() {
    return /^((?!chrome|android).)*safari/i.test(navigator.userAgent);
}
// Main control: Disable automatic clipboard reads and enable the local IME.
connConfig = {..., readClipboardDataByUser:isSafari(), useCustomIme:true}; 
var appInfo = {
  ...,
  connConfig: connConfig,
  ...
};
var sessionParam = {
  ...,
  appInfo: appInfo,
  ....
};
var wuyingSdk = Wuying.WebSDK;
session = wuyingSdk.createSession('appstream', sessionParam);
// Thumbnail configuration: Enable the local IME.
this.thumbnail = new window.Wuying.ThumbnailSDK({
  ...,
  connectionConfig: {
    useCustomIme: true,
  },
},
{
  onConnected: (data) => {
    this.thumbnail.session.getLocalConfig().setClipboardEnabled(true);
  },
  onDisConnected: (data) => {},
  onThumbnailData: (url) => {},
}
);

Construir el cuadro de entrada emergente

Cree un botón de portapapeles que abra el cuadro de entrada emergente. A continuación se muestra un ejemplo de código.

function showInput() {
  showCustomDialog();
  // Close the dialog when the overlay is clicked.
  document.querySelector('.modal-overlay').addEventListener('click', function (e) {
      if (e.target === this) {
          closeModal();
      }
  });

  // Close the dialog when the Escape key is pressed.
  document.addEventListener('keydown', function (e) {
      if (e.key === 'Escape') {
          closeModal();
      }
  });
}

function closeModal() {
  console.log('closeModal');
  const overlay = document.querySelector('.modal-overlay');
  if (overlay) {
      overlay.style.display = 'none';
      overlay.remove();
  }
}

function submitContent() {
  const content = document.querySelector('.input-field').value.trim();
  if (!content) {
      alert('Please enter content.');
      return;
  }
  // Sync the content to the Cloud Phone.
  sendMsgToCloudPhoneOperation(content);
  closeModal();
}

function showCustomDialog() {
  // Create the modal overlay.
  const overlay = document.createElement('div');
  overlay.className = 'modal-overlay';
  // Ensure the modal captures all events and is displayed at the highest level
  overlay.style.pointerEvents = 'all';
  overlay.style.zIndex = '9999';
  
  // Prevent events from propagating to underlying layers
  const stopPropagation = function(e) {
      e.stopPropagation();
  };
  
  overlay.addEventListener('contextmenu', stopPropagation, true);
  
  // Add event listeners to intercept all keyboard events
  overlay.addEventListener('keydown', stopPropagation, true);
  overlay.addEventListener('keyup', stopPropagation, true);
  overlay.addEventListener('keypress', stopPropagation, true);
  
  overlay.innerHTML = `
      <div class="modal">
          <div class="modal-header">
              <h2 class="modal-title">Clipboard</h2>
              <button class="close-btn" onclick="closeModal()">×</button>
          </div>
          
          <div class="input-container">
              <textarea 
                  class="input-field" 
                  placeholder="Enter content"
                  maxlength="500"
              ></textarea>
          </div>
          
          <button class="submit-btn" onclick="submitContent()">
              Paste Now
          </button>
      </div>
  `;

  document.body.appendChild(overlay);
  
  // Focus the textarea when the modal opens to ensure keyboard events are captured
  setTimeout(() => {
      const textarea = overlay.querySelector('.input-field');
      if (textarea) {
          textarea.focus();
      }
  }, 100);
}

Enviar texto al Cloud Phone

Activar la tarea de sincronización

function submitContent() {
  const content = document.querySelector('.input-field').value.trim();
  if (!content) {
      alert('Please enter content.');
      return;
  }
  // Sync the content to the Cloud Phone.
  sendMsgToCloudPhoneOperation(content);
  closeModal();
}

Sincronizar el contenido con el Cloud Phone

function sendMsgToCloudPhoneOperation(msg) {
  // For the main control session
  if (session) {
    session.setClipboardModule('sendClipboardDataToRemote', msg) 
  }
  // For thumbnail sessions
  for (const [key, value] of thumbnailSDKMap) {
      console.log('thumbnail sendMsgToCloudPhoneOperation ', key, msg);
      value.thumbnail.session.getClipboardModule().sendClipboardDataToRemote(msg);
  }
}

Notas de uso

El cuadro de diálogo personalizado debe capturar todos los eventos del teclado para evitar que otros elementos de la interfaz los intercepten. De esta manera, las pulsaciones de teclas se registran correctamente dentro del cuadro de diálogo.

overlay.addEventListener('contextmenu', stopPropagation, true);

// Add event listeners to intercept all keyboard events
overlay.addEventListener('keydown', stopPropagation, true);
overlay.addEventListener('keyup', stopPropagation, true);
overlay.addEventListener('keypress', stopPropagation, true);